共用方式為

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 Device Object。

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

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

例子

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

WdfDeviceInitSetDeviceType(
                           DeviceInit,
                           FILE_DEVICE_SERIAL_PORT
                           );

要求

要求 價值
目標平臺 普遍
最低 KMDF 版本 1.0
標頭 wdfdevice.h （包括 Wdf.h）
連結庫 Wdf01000.sys （請參閱架構連結庫版本控制。）
IRQL <= DISPATCH_LEVEL
DDI 合規性規則 ChildDeviceInitAPI（kmdf），DeviceInitAPI（kmdf），DriverCreate（kmdf），KmdfIrql （kmdf），KmdfIrql2（kmdf），KmdfIrqlExplicit（kmdf），PdoDeviceInitAPI（kmdf）