WdfDriverRetrieveDriverDataDirectoryString 関数 (wdfdriver.h)

  • [アーティクル]

[UMDF にのみ適用]

WdfDriverRetrieveDriverDataDirectoryString メソッドは、ドライバーが情報を格納できるディスク上のディレクトリへのパスを返します。 そのディレクトリ内のファイルは、特定のフレームワーク ドライバー オブジェクトに適用されます。

構文

NTSTATUS WdfDriverRetrieveDriverDataDirectoryString(
  [_In_] WDFDRIVER Driver,
  [_In_] WDFSTRING String
);

パラメーター

[_In_] Driver

WdfDriverCreate または WdfDeviceGetDriver の以前の呼び出しからドライバーが取得したドライバーのフレームワーク ドライバー オブジェクトへのハンドル。

[_In_] String

ドライバーが WdfStringCreate の以前の呼び出しから取得したフレームワーク文字列オブジェクトへのハンドル。 フレームワークは、要求されたドライバー ディレクトリの完全修飾パスを文字列オブジェクトに割り当てます。

戻り値

操作が成功した場合、WdfDriverRetrieveDriverDataDirectoryString はSTATUS_SUCCESSを返します。 それ以外の場合、このメソッドは適切な NTSTATUS エラー コードを返します。 詳細については、「 NTSTATUS 値」を参照してください。

注釈

同じ結果を得るには、代わりに KMDF ドライバーで IoGetDriverDirectory を呼び出す必要があります。

文字列オブジェクトの詳細については、「文字列オブジェクトの 使用」を参照してください。

例

次のコード例は、 WdfDriverRetrieveDriverDataDirectoryString を呼び出す方法を示しています。

NTSTATUS status;
WDFSTRING string;

status = WdfStringCreate(
                         NULL,
                         WDF_NO_OBJECT_ATTRIBUTES,
                         &string
                         );
if (NT_SUCCESS(status)) {
    status = WdfDriverRetrieveDriverDataDirectoryString(
                         Driver,
                         string
                         );
    if (!NT_SUCCESS(status)) {
        return status;
    }
}

要件

要件 値
最小 UMDF バージョン 2.27
Header wdfdriver.h
IRQL PASSIVE_LEVEL

こちらもご覧ください

IoGetDriverDirectory

_DRIVER_DIRECTORY_TYPE列挙