windows-rsのメモ
追記(2021/03/21)
雑多な新しい情報はスクラップのほうに書いています。
windows-rs
windows-rsはRust向けにWin32 APIの関数や構造体などを自動生成してくれるWin32 API本家本元のMicrosoftが作っているクレートで、クレート名はwindowsになっています。win32metadataで作られたwinmdファイルをwindows-rsのbuildマクロでRustの関数や構造体を生成します。使い方はwindows-rsのGetting startedをご覧ください。
以下のIssueでwindows-rsはwinapi-rsを置き換えるように取り組んでいることがわかります。
ちなみにwinrt-rsを改名してwindows-rsになったようです。
winapi-rsとどっちがいいの？(0.7.0 2021/04/08の話)
windwos-rsが0.7.0において少なくとも自分が使った範囲ではとなりますが、ウィンドウやDirect2D、Direct3Dのようなよく使われるAPIではインポート時点でエラーが出るようなことはなく動作で問題がありませんでした。2021年1月の頃に比べると各段に使いやすくなっておりwinapi-rsの置き換えを考え始めてもいいのではないかと思います。また、winapi-rsは2020年11月の終わり頃を最後にコミットがなく足りないAPIが追加されるかどうかも正直わからないような状況です。したがって、winapi-rsよりwindows-rsを使っていく方向でいいのではないかと思います。ただし、windows-rsやwin32metadataのリリースは2021年末の見込み[1]で安定版ではない事を留意してください。
2021/01/23の話
2021/01/23においては、下記のようにコンパイル失敗することがあったりしてまだ安定していないのでwinapi-rsのほうが使いやすいと思います。しかし、winapi-rsは足りないAPIがあったり最新のWindows SDKに追従できていないので、現状でも自分でwindows-rsに修正を加えたりして対処できるならwindows-rsのほうが使える場面があるでしょう。win32metadataやwindows-rsが安定してくればwindows-rsを使うほうがよくなるかなと思いますが、win32metadataのリリースは2021年末の見込み[1:1]なので安定板はまだ待たなければなりません。
あれこれ
BOOL
BOOLはwindows::BOOLで定義されており、is_okなどのRustに合わせた便利な関数が定義されていますが、is_okはself.0 != 0、is_errはself.0 == 0となっているので、例えばGetMessageWのようなBOOLが-1を返す関数では注意してください。
また、From<bool>が定義されているのでtrue.into()のようにintoで変換することができます。
bindings::Windows::Win32::SystemServices::BOOLになりました。
ok()でResult<()>にできたり、From<bool>も定義されているのでintoでboolに変換もできます。
返り値のHRESULT
返り値のHRESULTがwindows::ErrorCodeになっており、is_okなどいくつかRustに合わせた便利な関数が定義されています。i32をintoで変換することはできません。
NewTypeパターンの型
WPARAM、LPARAM、LRESULTなどの型がNewTypeパターンになっており、例えばLRESULTで0を返そうする場合LRESULT(0)のようにする必要があります。
(2021/04/08更新) 以下のエラーはなくなりました
UCharIteratorなどの関数ポインタを持つ構造体でmapがないと言われる
UCharIteratorなどの関数ポインタを持つ構造体でmapがないと言われるwindows::win32::intl::UCharIteratorのように*mut Option<関数ポインタの型>を持つ構造体でコンパイルが失敗します。Issueを出してみたところ、win32metadata側の問題のようです。
https://github.com/microsoft/windows-rs/issues/438
https://github.com/microsoft/win32metadata/issues/132
(2021/01/29追記)
windows-rs側でworkaroundを出そうという動きがあります。
api-ms-win-で始まるlibをリンクしようとして失敗する
api-ms-win-で始まるlibをリンクしようとして失敗するwinmdファイルにはWin32 APIの関数がどのDLLにあるか書かれているのですが、windows-rsがそのままDLL名を#[link(name = "...")]のnameに入れて生成するために起こります。以下のwindows-rsのコメントによるとRustでDLLに対する動的リンクのサポートまでDLL名を対応したlib名に書く必要があるようです。
https://github.com/microsoft/windows-rs/blob/master/crates/gen/src/function.rs
// TODO: need to generate libs until Rust supports dynamic linking against DLLs.
// This is actually the DLL name
ちなみに上記のコメントの下に次のコードがあり、既に書かれたコードと同様に必要なDLLとlibの対応を書き足すとリンクを通せるようになります。
let mut link = self.signature.method.impl_map().unwrap().scope().name();
if link == "ext-ms-win-core-iuri-l1-1-0" {
link = "urlmon";
} else if link == "api-ms-win-core-winrt-l1-1-0" {
link = "onecoreuap";
}
Discussion