共用方式為


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,則會停用它。

傳回值

沒有

言論

驅動程式可以在裝置啟動之前或之後呼叫此函式。

在裝置啟動時呼叫時(例如,從 EvtDriverDeviceAddEvtChildListCreateDeviceEvtDevicePrepareHardware),驅動程式應將 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

啟用和停用裝置介面