Função WdfUsbTargetDeviceGetInterface (wdfusb.h)

  • Artigo

[Aplica-se a KMDF e UMDF]

O método WdfUsbTargetDeviceGetInterface retorna um identificador para o objeto de interface USB da estrutura associado a um índice de interface especificado.

Sintaxe

WDFUSBINTERFACE WdfUsbTargetDeviceGetInterface(
  [in] WDFUSBDEVICE UsbDevice,
  [in] UCHAR        InterfaceIndex
);

Parâmetros

[in] UsbDevice

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

[in] InterfaceIndex

Um valor de índice baseado em zero que especifica um objeto de interface USB na configuração atual. Esse valor de índice pode não ser o mesmo que o número de interface definido pela especificação USB.

Retornar valor

WdfUsbTargetDeviceGetInterface retorna um identificador para um objeto de interface USB. Se o valor InterfaceIndex for inválido, esse método retornará NULL.

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

Comentários

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

Exemplos

O exemplo de código a seguir obtém um identificador para o primeiro objeto de interface USB que a estrutura criou para um dispositivo USB. Em seguida, o exemplo obtém o número de pontos de extremidade associados ao objeto de interface.

WDFUSBINTERFACE  UsbInterface;
BYTE  numEndpoints;

UsbInterface = WdfUsbTargetDeviceGetInterface(
                                              deviceContext->UsbTargetDevice,
                                              0
                                              );
numEndpoints = WdfUsbInterfaceGetNumEndpoints(
                                              UsbInterface,
                                              0
                                              );

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 (inclua Wdfusb.h)
Biblioteca Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
Regras de conformidade de DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf)

Confira também

WdfUsbTargetDeviceCreateWithParameters