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


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

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

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

Синтаксис

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

Параметры

[in] DeviceInit

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

[in] DeviceClassGuid

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

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

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

None

Remarks

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

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

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

Если драйвер вызывает WdfDeviceInitSetDeviceClass, он должен сделать это перед вызовом 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)
Библиотека Wdf01000.sys (см. раздел Управление версиями библиотеки платформы).
IRQL <= DISPATCH_LEVEL
Правила соответствия DDI ChildDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)