Función WdfDeviceInitSetDeviceClass (wdfdevice.h)

  • Artículo

[Solo se aplica a KMDF]

El método WdfDeviceInitSetDeviceClass especifica un GUID que identifica la clase de configuración del dispositivo del dispositivo.

Sintaxis

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

Parámetros

[in] DeviceInit

Puntero a una estructura de WDFDEVICE_INIT .

[in] DeviceClassGuid

Puntero a un GUID que identifica una sección del registro que contiene posibles invalidaciones para los parámetros DefaultSDDLString, DeviceType, DeviceCharacteristics y Exclusive .

Nota Siempre debe especificar un GUID de clase personalizado. No debe especificar un GUID de clase existente. Si especifica un GUID de clase existente, otros controladores que intentan especificar que el GUID de clase existente podría no instalarse o podría instalarse con una configuración de seguridad incorrecta.
 

Valor devuelto

None

Observaciones

El Registro puede contener valores que invalidan los valores que especifica un controlador cuando llama a WdfDeviceInitAssignSDDLString, WdfDeviceInitSetDeviceType, WdfDeviceInitSetCharacteristics y WdfDeviceInitSetExclusive. El controlador puede llamar a WdfDeviceInitSetDeviceClass para especificar un GUID que identifique la sección del registro que contiene los valores de invalidación.

Normalmente, un controlador llama a WdfDeviceInitSetDeviceClass solo si está creando un dispositivo de control.

Para obtener más información sobre el uso del registro, vea Establecer las propiedades del Registro de objetos de dispositivo después de la instalación.

Si un controlador llama a WdfDeviceInitSetDeviceClass, debe hacerlo antes de llamar a WdfDeviceCreate.

Para obtener más información sobre cómo llamar a WdfDeviceCreate, vea Crear un objeto de dispositivo framework.

Ejemplos

En el ejemplo de código siguiente se establece la clase de instalación de un dispositivo en la clase de dispositivo del sistema.

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

WdfDeviceInitSetDeviceClass(
                            DeviceInit,
                            &GUID_DEVCLASS_MYUNIQUEID
                            );

Requisitos

Requisito Value
Plataforma de destino Universal
Versión mínima de KMDF 1.0
Encabezado wdfdevice.h (incluya Wdf.h)
Library Wdf01000.sys (consulte Control de versiones de la biblioteca de marcos).
IRQL <= DISPATCH_LEVEL
Reglas de cumplimiento de DDI ChildDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)