WdfDeviceInitSetDeviceType 函式 (wdfdevice.h)

  • 發行項

[僅適用於 KMDF]

WdfDeviceInitSetDeviceType 方法會設定指定裝置的裝置類型。

語法

void WdfDeviceInitSetDeviceType(
  [in] PWDFDEVICE_INIT DeviceInit,
  [in] DEVICE_TYPE     DeviceType
);

參數

[in] DeviceInit

WDFDEVICE_INIT 結構的指標。

[in] DeviceType

識別裝置類型的FILE_DEVICE_XXXX值。 如需FILE_DEVICE_XXXX值的詳細資訊，請參閱 指定裝置類型。

傳回值

無

備註

如果驅動程式呼叫 WdfDeviceInitSetDeviceType，它必須先這麼做，才能呼叫 WdfDeviceCreate。

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

驅動程式指定的裝置類型會決定當驅動程式完成 I/O 要求時，架構所使用的預設優先順序提升值。 如需優先順序提升值的詳細資訊，請參閱 在完成 I/O 要求時指定優先順序提升。

如果您要撰寫 UMDF 驅動程式，您必須修改驅動程式的 INF 檔案，或進行登錄變更以指定裝置類型。 如需使用登錄的詳細資訊，請參閱 在安裝期間設定裝置物件登錄屬性。

範例

下列程式代碼範例指出裝置是序列裝置。

WdfDeviceInitSetDeviceType(
                           DeviceInit,
                           FILE_DEVICE_SERIAL_PORT
                           );

規格需求

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