Compartilhar via


Método IWDFUsbTargetDevice::RetrieveDeviceInformation (wudfusb.h)

[Aviso: UMDF 2 é a versão mais recente do UMDF e substitui UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum novo recurso está sendo adicionado ao UMDF 1 e há suporte limitado para UMDF 1 em versões mais recentes do Windows 10. Drivers universais do Windows devem usar UMDF 2. Para obter mais informações, consulte Introdução com UMDF.]

O método RetrieveDeviceInformation recupera informações do dispositivo do tipo especificado.

Sintaxe

HRESULT RetrieveDeviceInformation(
  [in]      ULONG InformationType,
  [in, out] ULONG *BufferLength,
  [out]     PVOID Buffer
);

Parâmetros

[in] InformationType

O tipo de informação que o driver UMDF solicita sobre o dispositivo.

[in, out] BufferLength

Um ponteiro para uma variável que, na entrada, contém o tamanho, em bytes, do buffer que RetrieveDeviceInformation fornece no Buffer. Na saída, esse parâmetro contém o tamanho que RetrieveDeviceInformation requer para Buffer.

[out] Buffer

Um ponteiro que recebe o buffer que contém as informações do dispositivo.

Retornar valor

RetrieveDeviceInformation retorna um dos seguintes valores:

Código de retorno Descrição
S_OK

RetrieveDeviceInformation recuperou com êxito as informações do dispositivo.

E_OUTOFMEMORY

RetrieveDeviceInformation encontrou uma falha de alocação.

Um código de erro definido em Winerror.h
Esse valor corresponde ao código de erro retornado pela API do WinUsb.

Comentários

Para obter informações sobre tipos de informações válidos que um driver UMDF pode passar para o parâmetro InformationType , consulte a função WinUsb_QueryDeviceInformation .

Se InformationType for DEVICE_SPEED (0x01), no retorno bem-sucedido, Buffer indicará a velocidade de operação do dispositivo. 0x03 indica alta velocidade ou superior; 0x01 indica velocidade total ou inferior.

O método RetrieveDeviceInformation gera uma solicitação UMDF e envia a solicitação de forma síncrona para o destino de E/S.

Exemplos

Para obter um exemplo de código de como usar o métodoRetrieveDeviceInformation , consulte IWDFUsbTargetPipe::SetPipePolicy.

Requisitos

Requisito Valor
Fim do suporte Indisponível no UMDF 2.0 e posterior.
Plataforma de Destino Área de Trabalho
Versão mínima do UMDF 1.5
Cabeçalho wudfusb.h (include Wudfusb.h)
DLL WUDFx.dll

Confira também

IWDFUsbTargetDevice

WinUsb_QueryDeviceInformation