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 |