Функция 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 .
Возвращаемое значение
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) |