Função WdfDeviceInitSetDeviceType (wdfdevice.h)

Artigo
02/07/2025

[Aplica-se somente ao KMDF]

O método WdfDeviceInitSetDeviceType define o tipo de dispositivo para um dispositivo especificado.

Sintaxe

void WdfDeviceInitSetDeviceType(
  [in] PWDFDEVICE_INIT DeviceInit,
  [in] DEVICE_TYPE     DeviceType
);

Parâmetros

[in] DeviceInit

Um ponteiro para uma estrutura WDFDEVICE_INIT.

[in] DeviceType

Um valor FILE_DEVICE_XXXX que identifica o tipo de dispositivo. Para obter mais informações sobre FILE_DEVICE_XXXX valores, consulte Especificando tipos de dispositivo.

Valor de retorno

Nenhum

Observações

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

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

O tipo de dispositivo especificado por um driver determina o valor de aumento de prioridade padrão que a estrutura usa quando o driver conclui uma solicitação de E/S. Para obter mais informações sobre valores de aumento de prioridade, consulte Especificando aumentos de prioridade ao concluir solicitações de E/S.

Se você estiver escrevendo um driver UMDF, deverá modificar o arquivo INF do driver ou fazer alterações no Registro para especificar um tipo de dispositivo. Para obter mais informações sobre como usar o registro, consulte Definindo propriedades do Registro de Objeto do Dispositivo durante a instalação.

Exemplos

O exemplo de código a seguir indica que um dispositivo é um dispositivo serial.

WdfDeviceInitSetDeviceType(
                           DeviceInit,
                           FILE_DEVICE_SERIAL_PORT
                           );

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), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), kmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)

Partilhar via