Функция WdfDeviceInitSetDeviceClass (wdfdevice.h)

Статья
02/07/2025

[Применимо только к KMDF]

Метод WdfDeviceInitSetDeviceClass указывает GUID, определяющий класс установки устройства устройства.

Синтаксис

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

Параметры

[in] DeviceInit

Указатель на структуру WDFDEVICE_INIT.

[in] DeviceClassGuid

Указатель на GUID, определяющий раздел реестра, содержащий возможные переопределения для DefaultSDDLString, DeviceType, DeviceCharacteristicsи эксклюзивных параметров.

Примечание Всегда следует указывать GUID пользовательского класса. Не следует указывать существующий GUID класса. Если указать существующий GUID класса, другие драйверы, которые пытаются указать, что существующий GUID класса может завершиться ошибкой установки или установки с неправильными параметрами безопасности.

Возвращаемое значение

Никакой

Замечания

Реестр может содержать значения, переопределяющие значения, заданные драйвером при вызове WdfDeviceInitAssignSDDLString, WdfDeviceInitSetDeviceType, WdfDeviceInitSetCharacteristicsи WdfDeviceInitSetExclusive. Драйвер может вызывать WdfDeviceInitSetDeviceClass, чтобы указать GUID, определяющий раздел реестра, содержащий переопределенные значения.

Как правило, драйвер вызывает WdfDeviceInitSetDeviceClass только в том случае, если он создает устройство управления .

Дополнительные сведения об использовании реестра см. в разделе Настройка свойств реестра объектов устройств после установки.

Если драйвер вызывает WdfDeviceInitSetDeviceClass, перед вызовом WdfDeviceCreate.

Дополнительные сведения о вызове WdfDeviceCreateсм. в создании объекта устройства Framework.

Примеры

В следующем примере кода для класса установки устройства устанавливается системный класс устройства.

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 (include Wdf.h)
библиотеки	Wdf01000.sys (см. управление версиями библиотеки Платформы).)
IRQL	<= DISPATCH_LEVEL
правил соответствия DDI	ChildDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)

Поделиться через