Função WdfDeviceInitSetDeviceType (wdfdevice.h)

  • Artigo

[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.

Retornar valor

Nenhum

Comentários

Se um driver chamar WdfDeviceInitSetDeviceType, ele deverá fazer isso 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 Configurando 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
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), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)