次の方法で共有

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 ファイルを提供するドライバーは、WdfDeviceAssignMofResourceName を呼び出す必要があります。通常は、EvtDriverDeviceAdd または EvtDevicePrepareHardware コールバック関数 内から呼び出す必要があります。 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
ヘッダー wdfdevice.h (Wdf.h を含む)
ライブラリ Wdf01000.sys (フレームワーク ライブラリのバージョン管理を参照)。
IRQL PASSIVE_LEVEL
DDI コンプライアンス規則 を する DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)