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を返します。 その他の戻り値は次のとおりです。

メソッドは、他の 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;
}

要件