WdfDeviceInitSetDeviceClass 函数 (wdfdevice.h)

  • 项目

[仅适用于 KMDF]

WdfDeviceInitSetDeviceClass 方法指定标识设备设置类的 GUID。

语法

void WdfDeviceInitSetDeviceClass(
  [in] PWDFDEVICE_INIT DeviceInit,
  [in] const GUID      *DeviceClassGuid
);

参数

[in] DeviceInit

指向 WDFDEVICE_INIT 结构的指针。

[in] DeviceClassGuid

指向 GUID 的指针，该 GUID 标识包含 DefaultSDDLString、 DeviceType、 DeviceCharacteristics 和 Exclusive 参数的可能替代的注册表部分。

注意 应始终指定自定义类 GUID。 不应指定现有的类 GUID。 如果指定现有类 GUID，尝试指定现有类 GUID 的其他驱动程序可能无法安装，或者安装时的安全设置不正确。
 

返回值

无

备注

注册表可以包含的值可以替代驱动程序在调用 WdfDeviceInitAssignSDDLString、 WdfDeviceInitSetDeviceType、 WdfDeviceInitSetCharacteristics 和 WdfDeviceInitSetExclusive 时指定的值。 驱动程序可以调用 WdfDeviceInitSetDeviceClass 来指定一个 GUID，用于标识包含重写值的注册表部分。

通常，驱动程序仅在创建控制设备时调用 WdfDeviceInitSetDeviceClass。

有关使用注册表的详细信息，请参阅 安装后设置设备对象注册表属性。

如果驱动程序调用 WdfDeviceInitSetDeviceClass，则必须在调用 WdfDeviceCreate 之前调用 WdfDeviceCreate。

有关调用 WdfDeviceCreate 的详细信息，请参阅 创建框架设备对象。

示例

下面的代码示例将设备的安装类设置为系统设备类。

DEFINE_GUID(GUID_DEVCLASS_MYUNIQUEID,
0xf149fe88, 0x f6cc, 0x47e3, 0x85, 0x94, 0xe2, 0xaa, 0xb6, 0xe0, 0x3b, 0xdf);

WdfDeviceInitSetDeviceClass(
                            DeviceInit,
                            &GUID_DEVCLASS_MYUNIQUEID
                            );

要求

要求 值
目标平台 通用
最低 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)