K32GetDeviceDriverFileNameW

指定したデバイス ドライバのパスを取得する。(Unicode)

K32GetDeviceDriverFileNameW ImageBase, lpFilename, nSize

ImageBase : [intptr] デバイス ドライバの読み込みアドレス。
lpFilename : [wstr] デバイス ドライバへのパスを受け取るバッファへのポインタ。
nSize : [int] lpFilename バッファのサイズ（文字数単位）。バッファがパスと終端 null 文字を収めるのに不足していれば、文字列は切り詰められる。

(プラグイン / モジュール : kernel32.dll)

解説

指定したデバイス ドライバのパスを取得する。(Unicode)

[戻り値]
関数が成功した場合、戻り値はバッファにコピーされた文字列の長さ（終端 null 文字を除く）を指定する。関数が失敗した場合、戻り値は 0
となる。拡張エラー情報を取得するには GetLastError を呼ぶ。

[備考]
Windows 7 および Windows Server 2008 R2 以降、Psapi.h は PSAPI
関数のバージョン番号を定めている。PSAPI
バージョン番号は、関数を呼ぶときに使う名前とプログラムが読み込むライブラリに影響する。PSAPI_VERSION が 2
以上の場合、この関数は Psapi.h で K32GetDeviceDriverFileName として定義され、Kernel32.lib
と Kernel32.dll にエクスポートされる。PSAPI_VERSION が 1 の場合、Psapi.h で
GetDeviceDriverFileName として定義され、Psapi.lib と Psapi.dll に
K32GetDeviceDriverFileName を呼ぶラッパーとしてエクスポートされる。旧バージョンの Windows と
Windows 7 以降の両方で動かすプログラムは常に GetDeviceDriverFileName
として呼ぶべきである。シンボルを正しく解決するためには、TARGETLIBS マクロに Psapi.lib
を追加し、-DPSAPI_VERSION=1 付きでコンパイルする。実行時動的リンクを使うには Psapi.dll を読み込む。
> [!NOTE] > psapi.h ヘッダーは GetDeviceDriverFileName を、UNICODE
プリプロセッサ定数の定義に基づいて ANSI 版か Unicode
版を自動選択するエイリアスとして定義している。エンコーディング中立のエイリアスとそうでないコードを混在させると、コンパイルまたは実行時エラーになるミスマッチが発生することがある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照のこと。

情報