次の方法で共有

WdfDeviceSetDeviceInterfaceStateEx 関数 (wdfdevice.h)

  • [アーティクル]

WdfDeviceSetDeviceInterfaceStateEx メソッドは、指定されたデバイスのデバイス インターフェイスを有効または無効にします。

構文

void WdfDeviceSetDeviceInterfaceStateEx(
  WDFDEVICE        Device,
  const GUID       *InterfaceClassGUID,
  PCUNICODE_STRING ReferenceString,
  BOOLEAN          IsInterfaceEnabled
);

パラメーター

Device

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

InterfaceClassGUID

デバイス インターフェイス クラスを識別する GUID へのポインター。

ReferenceString

デバイス インターフェイスの参照文字列を記述する UNICODE_STRING 構造体へのポインター。 このパラメーターは省略可能であり、NULL できます。

IsInterfaceEnabled

TRUE 場合、指定したデバイス インターフェイス インスタンスを有効にするブール値、または FALSE 場合は無効にします。

戻り値

何一つ

備考

ドライバーは、デバイスが起動する前または後に、この関数を呼び出すことができます。

デバイスが起動する前に呼び出された場合 (EvtDriverDeviceAdd 、EvtChildListCreateDevice、EvtDevicePrepareHardwareなど) は、ドライバー IsInterfaceEnabled を FALSE に設定して、PnP 起動時にインターフェイスが自動的に有効にならないようにする必要があります。 デバイスが起動する前にパラメーターを TRUE に設定することは冗長であるため、このような呼び出しは削除する必要があります。

デバイスの起動後に呼び出すときの動作は、WdfDeviceSetDeviceInterfaceStateと同じです。

必要条件

要件 価値
サポートされる最小クライアント Windows 10 バージョン 2004
最小 KMDF バージョン 1.31
UMDF の最小バージョン を する 1.31
ヘッダー wdfdevice.h (Wdf.h を含む)
ライブラリ Wdf01000.sys (KMDF);WUDFx02000.dll (UMDF)
IRQL PASSIVE_LEVEL

関連項目

WdfDeviceSetDeviceInterfaceState

デバイス インターフェイス の有効化と無効化