WdfDeviceSetCharacteristics 函式 (wdfdevice.h)
[僅適用於 KMDF]
WdfDeviceSetCharacteristics 方法會設定指定裝置的裝置特性。
語法
void WdfDeviceSetCharacteristics(
[in] WDFDEVICE Device,
[in] ULONG DeviceCharacteristics
);
參數
[in] Device
架構裝置物件的句柄。
[in] DeviceCharacteristics
值,由代表裝置特性的 ORed 系統定義常數所組成。 如需詳細資訊,請參閱 特性DEVICE_OBJECT 結構的成員。
傳回值
沒有
言論
如果驅動程式提供無效的物件句柄,就會發生錯誤檢查。
您應該先呼叫 EvtDriverDeviceAdd 回呼函式中的 WdfDeviceInitSetCharacteristics 方法來設定裝置特性,然後再呼叫 WdfDeviceCreate。 如果您的驅動程式在 EvtDriverDeviceAdd 回呼函式傳回之後,驅動程式通常應該在其 EvtDevicePrepareHardware 回呼函式中呼叫 WdfDeviceSetCharacteristics。
每個呼叫 WdfDeviceSetCharacteristics 會覆寫任何先前呼叫的設定。
例子
下列程式代碼範例會設定指定裝置的FILE_REMOVABLE_MEDIA特性。
WdfDeviceSetCharacteristics(
Device,
FILE_REMOVABLE_MEDIA
);
要求
要求 | 價值 |
---|---|
目標平臺 | 普遍 |
最低 KMDF 版本 | 1.0 |
標頭 | wdfdevice.h (包括 Wdf.h) |
連結庫 | Wdf01000.sys (請參閱架構連結庫版本控制。) |
IRQL | <=DISPATCH_LEVEL |
DDI 合規性規則 | DriverCreate(kmdf),KmdfIrql(kmdf),KmdfIrql2(kmdf),KmdfIrqlExplicit(kmdf) |