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 结构的 Characteristics 成员。
[in] OrInValues
一个布尔值。 如果此值为 TRUE,则 DeviceCharacteristics 值为具有现有设备特征的 ORed。 如果值为 FALSE,则 DeviceCharacteristics 值将替换现有设备特征。
返回值
无
备注
若要设置设备特征,请在调用 WdfDeviceCreate 之前,在 EvtDriverDeviceAdd 回调函数中调用 WdfDeviceInitSetCharacteristics 方法。 如果驱动程序在 EvtDriverDeviceAdd 回调函数返回之前无法确定设备的特征,请调用 WdfDeviceSetCharacteristics。
有关调用 WdfDeviceCreate 的详细信息,请参阅 创建框架设备对象。
框架始终设置FILE_DEVICE_SECURE_OPEN特征,因此驱动程序不必设置此特征。
每次调用 WdfDeviceInitSetCharacteristics 都会覆盖以前任何调用的设置。
示例
下面的代码示例指示设备是软盘。
WdfDeviceInitSetCharacteristics(
DeviceInit,
FILE_FLOPPY_DISKETTE,
FALSE
);
要求
要求 | 值 |
---|---|
目标平台 | 通用 |
最低 KMDF 版本 | 1.0 |
标头 | wdfdevice.h (包括 Wdf.h) |
Library | Wdf01000.sys (请参阅框架库 Versioning.) |
IRQL | <= DISPATCH_LEVEL |
DDI 符合性规则 | ChildDeviceInitAPI (kmdf) 、 ControlDeviceInitAPI (kmdf) 、 DeviceInitAPI (kmdf) 、 DriverCreate (kmdf) 、 KmdfIrql (kmdf) 、 KmdfIrql2 (kmdf) 、KmdfIrqlExplicit (kmdf) , PdoDeviceInitAPI (kmdf) |