GetDeviceDriverFileNameW

指定されたデバイスドライバーで利用可能なパスを取得する。(Unicode)

GetDeviceDriverFileNameW ImageBase, lpFilename, nSize

ImageBase : [intptr] デバイスドライバーのロードアドレス。
lpFilename : [wstr] デバイスドライバーへのパスを受け取るバッファへのポインタ。
nSize : [int] lpFilename バッファのサイズ（文字数）。バッファがパスと終端の null 文字を格納するのに十分でない場合、文字列は切り詰められる。

(プラグイン / モジュール : psapi.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
として定義され、K32GetDeviceDriverFileName を呼び出すラッパーとして Psapi.lib および
Psapi.dll からエクスポートされる。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)
を参照。

情報