Praca z interfejsami USB

Struktura reprezentuje każdy interfejs USB jako obiekt interfejsu USB frameworku. Gdy sterownik tworzy obiekt urządzenia USB w frameworku, framework tworzy obiekt interfejsu USB dla każdego interfejsu w pierwszej konfiguracji USB urządzenia.

Większość urządzeń USB ma tylko jeden interfejs, a interfejs ma tylko jedno ustawienie alternatywne. Sterowniki dla takich urządzeń zwykle nie muszą używać metod obiektów definiowanych przez obiekt interfejsu USB platformy.

Jeśli sterownik obsługuje urządzenia USB, które zapewniają wiele interfejsów lub ustawień alternatywnych, metody obiektów interfejsu umożliwiają sterownikowi wykonywanie następujących operacji:

• Uzyskaj informacje o interfejsie.

• Wybierz alternatywne ustawienie dla interfejsu USB.

Uzyskiwanie informacji o interfejsie

Po wywołaniu przez sterownik funkcji WdfUsbTargetDeviceCreateWithParameters, może on wywołać WdfUsbTargetDeviceGetInterface, aby uzyskać uchwyt do obiektu interfejsu USB frameworku, który reprezentuje jeden z interfejsów USB urządzenia. Następnie sterownik może wywołać kilka metod, które obiekt interfejsu USB definiuje do uzyskiwania informacji o interfejsie USB.

Twój sterownik może wywołać następujące metody w dowolnym momencie po wywołaniu WdfUsbTargetDeviceCreateWithParameters:

WdfUsbInterfaceGetInterfaceNumber
Zwraca numer interfejsu USB skojarzony z obiektem interfejsu USB.

WdfUsbInterfaceGetDescriptor
Pobiera deskryptor interfejsu USB skojarzony z jednym z alternatywnych ustawień interfejsu USB.

WdfUsbInterfaceGetNumEndpoints
Zwraca liczbę punktów końcowych skojarzonych z jednym z alternatywnych ustawień interfejsu USB.

WdfUsbInterfaceGetEndpointInformation
Pobiera informacje o punkcie końcowym i powiązanym kanale danych.

Sterownik może wywołać następujące metody po wywołaniu WdfUsbTargetDeviceSelectConfig:

WdfUsbInterfaceGetConfiguredSettingIndex
Zwraca wartość indeksu, która identyfikuje alternatywne ustawienie aktualnie wybrane dla interfejsu USB.

WdfUsbInterfaceGetNumConfiguredPipes
Zwraca liczbę potoków skonfigurowanych dla określonego interfejsu urządzenia USB.

WdfUsbInterfaceGetConfiguredPipe
Zwraca uchwyt do obiektu potoku w ramach struktury, który jest powiązany z określonym interfejsem urządzenia USB i indeksem potoku.

Wybieranie alternatywnego ustawienia dla interfejsu USB

Po wywołaniu WdfUsbTargetDeviceCreateWithParameters przez sterownik, sterownik może wywołać WdfUsbInterfaceGetNumSettings, aby uzyskać liczbę ustawień alternatywnych, które obsługuje interfejs USB.

Po wywołaniu sterownika WdfUsbTargetDeviceSelectConfig w celu wybrania konfiguracji urządzenia USB sterownik może wywołać WdfUsbInterfaceSelectSetting , aby wybrać alternatywne ustawienie dla jednego z interfejsów USB konfiguracji.

Alternatywne ustawienia urządzenia muszą być numerowane w sposób ciągły, zaczynając od zera.

Aby uzyskać powiązane informacje, zobacz Jak wybrać alternatywne ustawienie w interfejsie USB.