WdfDeviceSetPnpCapabilities 関数 (wdfdevice.h)

  • [アーティクル]

[KMDF と UMDF に適用]

WdfDeviceSetPnpCapabilities メソッドは、デバイスのプラグ アンド プレイ機能を報告します。

構文

void WdfDeviceSetPnpCapabilities(
  [in] WDFDEVICE                    Device,
  [in] PWDF_DEVICE_PNP_CAPABILITIES PnpCapabilities
);

パラメーター

[in] Device

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

[in] PnpCapabilities

ドライバーによって割り当てられた WDF_DEVICE_PNP_CAPABILITIES 構造体へのポインター。

戻り値

なし

解説

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

ドライバーは通常、次のいずれかのコールバック関数内から WdfDeviceSetPnpCapabilities を呼び出します。

デバイスのドライバー スタック内の複数のドライバーが WdfDeviceSetPnpCapabilities を呼び出す場合、プラグ アンド プレイ マネージャーは、スタック内で最も高いドライバーによって提供される値を使用します。

例

次のコード例では、WDF_DEVICE_PNP_CAPABILITIES構造体を初期化し、 WdfDeviceSetPnpCapabilities を呼び出します。

WDF_DEVICE_PNP_CAPABILITIES  pnpCaps;

WDF_DEVICE_PNP_CAPABILITIES_INIT(&pnpCaps);
pnpCaps.SurpriseRemovalOK = WdfTrue;

WdfDeviceSetPnpCapabilities(
                            device,
                            &pnpCaps
                            );

要件

要件 値
対象プラットフォーム ユニバーサル
最小 KMDF バージョン 1.0
最小 UMDF バージョン 2.0
Header wdfdevice.h (Wdf.h を含む)
Library Wdf01000.sys (KMDF);WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
DDI コンプライアンス規則 DriverCreate(kmdf)、 KmdfIrql(kmdf)、 KmdfIrql2(kmdf)、KmdfIrqlExplicit(kmdf)

こちらもご覧ください

WDF_DEVICE_PNP_CAPABILITIES

WDF_DEVICE_PNP_CAPABILITIES_INIT

WdfDeviceSetPowerCapabilities