Função WdfDeviceInitSetDeviceClass (wdfdevice.h)

  • Artigo

[Aplica-se somente ao KMDF]

O método WdfDeviceInitSetDeviceClass especifica um GUID que identifica a classe de configuraçã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, DeviceCharacteristics e Exclusive .

Nota Você sempre deve especificar um GUID de classe personalizada. 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 pode falhar na instalação ou podem ser instalados com configurações de segurança incorretas.
 

Retornar valor

Nenhum

Comentários

O registro pode conter valores que substituem os valores que um driver especifica quando chama WdfDeviceInitAssignSDDLString, WdfDeviceInitSetDeviceType, WdfDeviceInitSetCharacteristics e 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 Configurando propriedades do registro de objeto do dispositivo após a instalação.

Se um driver chamar WdfDeviceInitSetDeviceClass, ele deverá fazer isso 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
Plataforma de Destino Universal
Versão mínima do KMDF 1.0
Cabeçalho wdfdevice.h (inclua Wdf.h)
Biblioteca Wdf01000.sys (consulte Controle de versão da biblioteca de 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)