Função WdfUsbInterfaceGetDescriptor (wdfusb.h)

  • Artigo

[Aplica-se a KMDF e UMDF]

O método WdfUsbInterfaceGetDescriptor recupera o descritor de interface USB associado a uma configuração alternativa especificada de uma interface USB especificada.

Sintaxe

void WdfUsbInterfaceGetDescriptor(
  [in]  WDFUSBINTERFACE           UsbInterface,
  [in]  UCHAR                     SettingIndex,
  [out] PUSB_INTERFACE_DESCRIPTOR InterfaceDescriptor
);

Parâmetros

[in] UsbInterface

Um identificador para um objeto de interface USB que foi obtido chamando WdfUsbTargetDeviceGetInterface.

[in] SettingIndex

Um valor de índice que identifica uma configuração alternativa para a interface. Para obter mais informações sobre configurações alternativas, consulte a especificação USB.

[out] InterfaceDescriptor

Um ponteiro para uma estrutura de USB_INTERFACE_DESCRIPTOR alocada pelo chamador que a estrutura preenche.

Retornar valor

Nenhum

Comentários

Se o valor SettingIndex for inválido, a estrutura USB_INTERFACE_DESCRIPTOR poderá receber dados inválidos.

Um bug marcar ocorrerá se o driver fornecer um identificador de objeto inválido.

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

Exemplos

O exemplo de código a seguir obtém o índice de configuração alternativo para uma interface USB especificada. Em seguida, o exemplo obtém o descritor de interface USB que representa a configuração alternativa atual da interface USB.

BYTE  settingIndex;
USB_INTERFACE_DESCRIPTOR  interfaceDescriptor;

settingIndex = WdfUsbInterfaceGetConfiguredSettingIndex(
                             UsbInterface
                             );

WdfUsbInterfaceGetDescriptor(
                             UsbInterface,
                             settingIndex,
                             &interfaceDescriptor
                             );

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 <=DISPATCH_LEVEL
Regras de conformidade da DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf)

Confira também

USB_INTERFACE_DESCRIPTOR

WdfUsbTargetDeviceGetInterface