Função WdfUsbInterfaceGetNumSettings (wdfusb.h)

[Aplica-se a KMDF e UMDF]

O método WdfUsbInterfaceGetNumSettings retorna o número de configurações alternativas compatíveis com uma interface USB especificada.

Sintaxe

BYTE WdfUsbInterfaceGetNumSettings(
  [in] WDFUSBINTERFACE UsbInterface
);

Parâmetros

[in] UsbInterface

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

Retornar valor

WdfUsbInterfaceGetNumSettings retorna o número de configurações alternativas compatíveis com a interface USB especificada.

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

Comentários

Seu driver pode chamar WdfUsbInterfaceGetNumSettings depois de ter chamado WdfUsbTargetDeviceCreateWithParameters.

Para obter mais informações sobre o método WdfUsbInterfaceGetNumSettings 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 configurações alternativas disponíveis para uma interface USB especificada.

BYTE altSettings;

altSettings = WdfUsbInterfaceGetNumSettings(UsbInterface);

Requisitos

Requisito Valor
Plataforma de Destino Universal
Versão mínima do KMDF 1.5
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

WdfUsbTargetDeviceCreateWithParameters

WdfUsbTargetDeviceGetInterface

WdfUsbTargetDeviceSelectConfig