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

啟用和停用裝置介面