WdfDeviceAssignMofResourceName 関数 (wdfdevice.h)

[KMDF にのみ適用]

WdfDeviceAssignMofResourceName メソッドは、指定したデバイスの MOF リソース名を登録します。

構文

NTSTATUS WdfDeviceAssignMofResourceName(
  [in] WDFDEVICE        Device,
  [in] PCUNICODE_STRING MofResourceName
);

パラメーター

[in] Device

フレームワーク デバイス オブジェクトへのハンドル。

[in] MofResourceName

MOF リソースの名前を指定する UNICODE_STRING 構造体へのポインター。

戻り値

操作が成功した場合、 WdfDeviceAssignMofResourceName は STATUS_SUCCESSを返します。 その他の戻り値は次のとおりです。

リターン コード	説明
STATUS_INVALID_DEVICE_REQUEST	ドライバーは既に WdfDeviceAssignMofResourceName を呼び出しています。
STATUS_INSUFFICIENT_RESOURCES	十分なメモリがありません。

 

メソッドは、他の NTSTATUS 値を返す場合があります。

ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。

注釈

WMI をサポートする MOF ファイルを提供するドライバーは、通常、EvtDriverDeviceAdd または EvtDevicePrepareHardware コールバック関数内から WdfDeviceAssignMofResourceName を呼び出す必要があります。 MOF リソース名は、ドライバーがリソース スクリプト (RC) ファイルの MofResource ステートメントで指定するファイル名です。 MOF リソース名の指定の詳細については、「 ドライバーの MOF ファイルのコンパイル」を参照してください。

バス上のデバイスを列挙するドライバーは、親デバイスの WdfDeviceAssignMofResourceName を呼び出すことができます。フレームワークでは、子デバイスに親の MOF リソース名が使用されます。

WMI の詳細については、「 Framework-Based ドライバーでの WMI のサポート」を参照してください。

例

次のコード例では、MOF リソース名を表す Unicode 文字列を宣言し、その名前を登録します。

NTSTATUS  status;
DECLARE_CONST_UNICODE_STRING(mofRsrcName, MOFRESOURCENAME);

status = WdfDeviceAssignMofResourceName(
                                        Device,
                                        &mofRsrcName
                                        );
if (!NT_SUCCESS(status)) {
    return status;
}

要件

要件	値
対象プラットフォーム	ユニバーサル
最小 KMDF バージョン	1.0
Header	wdfdevice.h (Wdf.h を含む)
Library	Wdf01000.sys (「Framework ライブラリのバージョン管理」を参照)。
IRQL	PASSIVE_LEVEL
DDI コンプライアンス規則	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)