Função WdfUsbTargetDeviceGetInterface (wdfusb.h)
[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) |