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 |