Função WdfUsbTargetDeviceGetDeviceDescriptor (wdfusb.h)

  • Artigo

[Aplica-se a KMDF e UMDF]

O método WdfUsbTargetDeviceGetDeviceDescriptor recupera o descritor de dispositivo USB para o dispositivo USB associado a um objeto de dispositivo USB de estrutura especificado.

Sintaxe

void WdfUsbTargetDeviceGetDeviceDescriptor(
  [in]  WDFUSBDEVICE           UsbDevice,
  [out] PUSB_DEVICE_DESCRIPTOR UsbDeviceDescriptor
);

Parâmetros

[in] UsbDevice

Um identificador para um objeto de dispositivo USB que foi obtido de uma chamada anterior para WdfUsbTargetDeviceCreateWithParameters.

[out] UsbDeviceDescriptor

Um ponteiro para uma estrutura de USB_DEVICE_DESCRIPTOR alocada pelo chamador que recebe o descritor de dispositivo USB.

Retornar valor

Nenhum

Comentários

Um bug marcar ocorrerá se um identificador de objeto fornecido pelo driver for inválido.

Para obter mais informações sobre o método WdfUsbTargetDeviceGetDeviceDescriptor e destinos de E/S USB, consulte Destinos de E/S USB.

Exemplos

O exemplo de código a seguir obtém o descritor de dispositivo USB para um dispositivo. O exemplo armazena o descritor no espaço de contexto definido pelo driver.

PMY_DEVICE_CONTEXT  myDeviceContext;

myDeviceContext = GetDeviceContext(device);

WdfUsbTargetDeviceGetDeviceDescriptor(
                                      myDeviceContext->UsbTargetDevice,
                                      &myDeviceContext->UsbDeviceDescr
                                      );

Requisitos

Requisito Valor
Plataforma de Destino Universal
Versão mínima do KMDF 1.0
Versão mínima do UMDF 2,0
Cabeçalho wdfusb.h (include Wdfusb.h)
Biblioteca Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL PASSIVE_LEVEL
Regras de conformidade da DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf)

Confira também

USB_DEVICE_DESCRIPTOR

WdfUsbTargetDeviceCreateWithParameters