Función WdfDeviceInitSetDeviceClass (wdfdevice.h)

[Solo se aplica a KMDF]

El método WdfDeviceInitSetDeviceClass especifica un GUID que identifica la clase de configuración de 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 el DefaultSDDLString, DeviceType, DeviceCharacteristicsy parámetros 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

Ninguno

Observaciones

El registro puede contener valores que invalidan los valores que especifica un controlador cuando llama a WdfDeviceInitAssignSDDLString, WdfDeviceInitSetDeviceType, WdfDeviceInitSetCharacteristicsy 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 de .

Para obtener más información sobre cómo usar el Registro, vea Establecer 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 Creating a Framework Device Object.

Ejemplos

En el ejemplo de código siguiente se establece la clase de configuració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	Valor
de la plataforma de destino de	Universal
versión mínima de KMDF	1.0
encabezado de	wdfdevice.h (incluya Wdf.h)
biblioteca de	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)