WdfDeviceSetDeviceInterfaceState 関数 (wdfdevice.h)

[KMDF と UMDF に適用]

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

注意

ドライバーは、デバイスが起動した後にのみ、この関数を呼び出す必要があります。 デバイスの追加からインターフェイスの状態を変更するには、代わりに WdfDeviceSetDeviceInterfaceStateEx を呼び出します。

構文

void WdfDeviceSetDeviceInterfaceState(
  [in]           WDFDEVICE        Device,
  [in]           const GUID       *InterfaceClassGUID,
  [in, optional] PCUNICODE_STRING ReferenceString,
  [in]           BOOLEAN          IsInterfaceEnabled
);

パラメーター

[in] Device

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

[in] InterfaceClassGUID

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

[in, optional] ReferenceString

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

[in] IsInterfaceEnabled

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

戻り値

なし

解説

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

デバイス インターフェイスと WdfDeviceSetDeviceInterfaceState メソッドの詳細については、「 デバイス インターフェイスの使用」を参照してください。

次のコード例では、ドライバーの COM ポート インターフェイスを無効にします。

WdfDeviceSetDeviceInterfaceState (
                                  Device,
                                  (LPGUID) &GUID_DEVINTERFACE_COMPORT,
                                  NULL,
                                  FALSE
                                  );

要件

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

こちらもご覧ください

UNICODE_STRING

WdfDeviceCreateDeviceInterfaceWdfDeviceSetDeviceInterfaceStateEx