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