WdfDeviceSetCharacteristics 函数 (wdfdevice.h)

  • 项目

[仅适用于 KMDF]

WdfDeviceSetCharacteristics 方法为指定设备设置设备特征。

语法

void WdfDeviceSetCharacteristics(
  [in] WDFDEVICE Device,
  [in] ULONG     DeviceCharacteristics
);

参数

[in] Device

框架设备对象的句柄。

[in] DeviceCharacteristics

一个 值，该值由表示设备特征的 ORed 系统定义的常量组成。 有关详细信息，请参阅 DEVICE_OBJECT 结构的特征成员。

返回值

无

备注

如果驱动程序提供无效的对象句柄，则会发生 bug 检查。

在调用 WdfDeviceCreate 之前，应通过在 EvtDriverDeviceAdd 回调函数中调用 WdfDeviceInitSetCharacteristics 方法来设置设备特征。 如果驱动程序在 EvtDriverDeviceAdd 回调函数返回之前无法确定设备的特征，则驱动程序通常应在其 EvtDevicePrepareHardware 回调函数中调用 WdfDeviceSetCharacteristics。

每次调用 WdfDeviceSetCharacteristics 都会覆盖任何先前调用的设置。

示例

下面的代码示例设置指定设备的FILE_REMOVABLE_MEDIA特征。

WdfDeviceSetCharacteristics(
                            Device,
                            FILE_REMOVABLE_MEDIA
                            );

要求

要求 值
目标平台 通用
最低 KMDF 版本 1.0
标头 wdfdevice.h (包括 Wdf.h)
Library Wdf01000.sys (请参阅框架库版本控制.)
IRQL <=DISPATCH_LEVEL
DDI 符合性规则 DriverCreate (kmdf) 、 KmdfIrql (kmdf) 、 KmdfIrql2 (kmdf) 、 KmdfIrqlExplicit (kmdf)

另请参阅

WdfDeviceGetCharacteristics

WdfDeviceInitSetCharacteristics