Werken met USB-interfaces

Het framework vertegenwoordigt elke USB-interface als een -framework USB-interfaceobject. Wanneer een stuurprogramma een FRAMEWORK USB-apparaatobject maakt, maakt het framework een FRAMEWORK USB-interfaceobject voor elke USB-interface die de eerste USB-configuratie van het apparaat bevat.

De meeste USB-apparaten hebben slechts één interface en de interface heeft slechts één alternatieve instelling. Stuurprogramma's voor dergelijke apparaten hoeven doorgaans niet de objectmethoden te gebruiken die door het USB-interfaceobject van het framework worden gedefinieerd.

Als uw stuurprogramma USB-apparaten ondersteunt die meerdere interfaces of alternatieve instellingen bieden, kunnen interfaceobjectmethoden het stuurprogramma de volgende bewerkingen uitvoeren:

• Verkrijg interface-informatie.

• Selecteer een alternatieve instelling voor een USB-interface.

interfacegegevens verkrijgen

Nadat het stuurprogramma WdfUsbTargetDeviceCreateWithParametersheeft aangeroepen, kan het WdfUsbTargetDeviceGetInterface aanroepen om een ingang te verkrijgen voor een FRAMEWORK USB-interfaceobject dat een van de USB-interfaces van het apparaat vertegenwoordigt. Vervolgens kan uw stuurprogramma verschillende methoden aanroepen die het USB-interfaceobject definieert voor het verkrijgen van informatie over de USB-interface.

Uw driver kan altijd de volgende methoden aanroepen nadat de WdfUsbTargetDeviceCreateWithParametersheeft aangeroepen:

WdfUsbInterfaceGetInterfaceNumber
Retourneert het USB-interfacenummer dat is gekoppeld aan een USB-interfaceobject.

WdfUsbInterfaceGetDescriptor
Haalt de USB-interfacedescriptor op die is gekoppeld aan een van de alternatieve instellingen van een USB-interface.

WdfUsbInterfaceGetNumEndpoints
Retourneert het aantal eindpunten dat is gekoppeld aan een van de alternatieve instellingen van een USB-interface.

WdfUsbInterfaceGetEndpointInformation
Haalt informatie op over een eindpunt en de bijbehorende pijp.

Uw stuurprogramma kan de volgende methoden aanroepen nadat deze WdfUsbTargetDeviceSelectConfigheeft aangeroepen:

WdfUsbInterfaceGetConfiguredSettingIndex
Retourneert een indexwaarde die de alternatieve instelling identificeert die momenteel is geselecteerd voor een USB-interface.

WdfUsbInterfaceGetNumConfiguredPipes
Retourneert het aantal pijpen dat is geconfigureerd voor een opgegeven USB-apparaatinterface.

WdfUsbInterfaceGetConfiguredPipe
Retourneert een ingang naar het framework pipe-object dat is gekoppeld aan een opgegeven USB-apparaatinterface en pijpindex.

een alternatieve instelling voor een USB-interface selecteren

Nadat een stuurprogramma WdfUsbTargetDeviceCreateWithParametersheeft aangeroepen, kan het stuurprogramma WdfUsbInterfaceGetNumSettings aanroepen om het aantal alternatieve instellingen te verkrijgen dat door een USB-interface wordt ondersteund.

Nadat een stuurprogramma WdfUsbTargetDeviceSelectConfig heeft aangeroepen om een configuratie voor een USB-apparaat te selecteren, kan het stuurprogramma WdfUsbInterfaceSelectSetting aanroepen om een alternatieve instelling te selecteren voor een van de USB-interfaces van de configuratie.

De alternatieve instellingen van het apparaat moeten aaneengesloten worden genummerd, beginnend met nul.

Zie Een alternatieve instelling selecteren in een USB-interfacevoor verwante informatie.