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的详细信息,请参阅 创建框架设备对象。
驱动程序指定的设备类型确定驱动程序完成 I/O 请求时框架使用的默认优先级提升值。 有关优先级提升值的详细信息,请参阅 完成 I/O 请求时指定优先级提升。
如果要编写 UMDF 驱动程序,则必须修改驱动程序的 INF 文件或进行注册表更改以指定设备类型。 有关使用注册表的详细信息,请参阅 安装期间设置设备对象注册表属性。
例子
下面的代码示例指示设备是串行设备。
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) |