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） |