Função WdfDeviceInitSetDeviceClass (wdfdevice.h)

Artigo
02/07/2025

[Aplica-se somente ao KMDF]

O método WdfDeviceInitSetDeviceClass especifica um GUID que identifica a classe de instalação de dispositivo do dispositivo.

Sintaxe

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

Parâmetros

[in] DeviceInit

Um ponteiro para uma estrutura WDFDEVICE_INIT.

[in] DeviceClassGuid

Ponteiro para um GUID que identifica uma seção do registro que contém possíveis substituições para os parâmetros DefaultSDDLString, DeviceType, DeviceCharacteristicse Exclusive.

Observação Você sempre deve especificar um GUID de classe personalizado. Você não deve especificar um GUID de classe existente. Se você especificar um GUID de classe existente, outros drivers que tentam especificar que o GUID de classe existente poderá falhar ao instalar ou instalar com configurações de segurança incorretas.

Valor de retorno

Nenhum

Observações

O registro pode conter valores que substituem os valores que um driver especifica quando chama WdfDeviceInitAssignSDDLString, WdfDeviceIn WdfDeviceInitSetCharacteristicse WdfDeviceInitSetExclusive. O driver pode chamar WdfDeviceInitSetDeviceClass para especificar um GUID que identifique a seção do registro que contém os valores de substituição.

Normalmente, um driver chama WdfDeviceInitSetDeviceClass somente se estiver criando um dispositivo de controle .

Para obter mais informações sobre como usar o registro, consulte Definindo propriedades do Registro de Objeto do Dispositivo após a instalação.

Se um driver chamar WdfDeviceInitSetDeviceClass, ele deverá fazê-lo antes de chamar WdfDeviceCreate.

Para obter mais informações sobre como chamar WdfDeviceCreate, consulte Criando um objeto de dispositivo framework.

Exemplos

O exemplo de código a seguir define a classe de instalação de um dispositivo para a classe de dispositivo do 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
da Plataforma de Destino	Universal
versão mínima do KMDF	1.0
cabeçalho	wdfdevice.h (inclua Wdf.h)
biblioteca	Wdf01000.sys (consulte o Controle de Versão da Biblioteca da Estrutura.)
IRQL	<= DISPATCH_LEVEL
regras de conformidade de DDI	ChildDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), kmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)

Compartilhar via