Função WdfUsbInterfaceGetEndpointInformation (wdfusb.h)

  • Artigo

[Aplica-se a KMDF e UMDF]

O método WdfUsbInterfaceGetEndpointInformation recupera informações sobre um ponto de extremidade de dispositivo USB especificado e seu pipe associado.

Sintaxe

void WdfUsbInterfaceGetEndpointInformation(
  [in]      WDFUSBINTERFACE           UsbInterface,
  [in]      UCHAR                     SettingIndex,
  [in]      UCHAR                     EndpointIndex,
  [in, out] PWDF_USB_PIPE_INFORMATION EndpointInfo
);

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.

[in] EndpointIndex

Um valor de índice que identifica um ponto de extremidade associado à configuração alternativa especificada da interface especificada. (Esse valor de índice não é o endereço do ponto de extremidade.)

[in, out] EndpointInfo

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

Retornar valor

Nenhum

Comentários

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

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

Exemplos

O exemplo de código a seguir obtém o número de pontos de extremidade compatíveis com uma interface USB e, em seguida, chama WdfUsbInterfaceGetEndpointInformation para cada ponto de extremidade.

WDF_USB_PIPE_INFORMATION endPointInfo;
BYTE settingIndex, i;

settingIndex = 0;
numEndpoints = WdfUsbInterfaceGetNumEndpoints(
                                          UsbInterface,
                                          settingIndex
                                          );

for (i = 0; i < numEndpoints; i++){
    WDF_USB_PIPE_INFORMATION_INIT(&endPointInfo);
    WdfUsbInterfaceGetEndpointInformation(
                                          UsbInterface,
                                          settingIndex,
                                          i,
                                          &endPointInfo
                                          );

    //
    // Examine endpoint information here.
    //
...
}

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

WDF_USB_PIPE_INFORMATION

WdfUsbInterfaceGetNumEndpoints

WdfUsbTargetDeviceGetInterface