WdfDeviceInitSetCharacteristics 函式 (wdfdevice.h)

  • 發行項

[僅適用於 KMDF]

WdfDeviceInitSetCharacteristics 方法會設定指定裝置的裝置特性。

語法

void WdfDeviceInitSetCharacteristics(
  [in] PWDFDEVICE_INIT DeviceInit,
  [in] ULONG           DeviceCharacteristics,
  [in] BOOLEAN         OrInValues
);

參數

[in] DeviceInit

WDFDEVICE_INIT 結構的指標。

[in] DeviceCharacteristics

值，由代表裝置特性的 ORed 系統定義常數所組成。 如需詳細資訊，請參閱 DEVICE_OBJECT 結構的特性成員。

[in] OrInValues

Boolean 值。 如果此值為TRUE，DeviceCharacteristics 值會是具有現有裝置特性的 ORed。 如果值為 FALSE，DeviceCharacteristics 值會取代現有的裝置特性。

傳回值

無

備註

若要設定裝置特性，請先在 EvtDriverDeviceAdd 回呼函式中呼叫 WdfDeviceInitSetCharacteristics 方法，再呼叫 WdfDeviceCreate。 如果您的驅動程式在 EvtDriverDeviceAdd 回呼函式傳回之前無法判斷裝置的特性，請呼叫 WdfDeviceSetCharacteristics。

如需呼叫 WdfDeviceCreate 的詳細資訊，請參閱 建立 Framework 裝置物件。

架構一律會設定FILE_DEVICE_SECURE_OPEN特性，因此您的驅動程式不需要設定此特性。

每個 對 WdfDeviceInitSetCharacteristics 的呼叫都會覆寫任何先前呼叫的設定。

範例

下列程式代碼範例指出裝置是磁碟驅動器。

WdfDeviceInitSetCharacteristics(
                                DeviceInit,
                                FILE_FLOPPY_DISKETTE,
                                FALSE
                                );

規格需求

需求 值
目標平台 Universal
最小 KMDF 版本 1.0
標頭 wdfdevice.h (包含 Wdf.h)
程式庫 Wdf01000.sys (請參閱 Framework Library Versioning.)
IRQL <= DISPATCH_LEVEL
DDI 合規性規則 ChildDeviceInitAPI (kmdf) 、 ControlDeviceInitAPI (kmdf) 、 DeviceInitAPI (kmdf) 、 DriverCreate (kmdf) 、 KmdfIrql (kmdf) 、 KmdfIrql2 (kmdf ) 、KmdfIrqlExplicit (kmdf) 、 PdoDeviceInitAPI (kmdf)

另請參閱

WdfDeviceSetCharacteristics