wdfusb.h-Header

Dieser Header wird von wdf verwendet. Weitere Informationen finden Sie unter

• Windows-Treiberframework

wdfusb.h enthält die folgenden Programmierschnittstellen:

Functions

WDF_USB_CONTINUOUS_READER_CONFIG_INIT Die WDF_USB_CONTINUOUS_READER_CONFIG_INIT-Funktion initialisiert eine WDF_USB_CONTINUOUS_READER_CONFIG-Struktur.
WDF_USB_CONTROL_SETUP_PACKET_INIT Die WDF_USB_CONTROL_SETUP_PACKET_INIT-Funktion initialisiert eine WDF_USB_CONTROL_SETUP_PACKET-Struktur für eine USB-Standardsteuerungsübertragung.
WDF_USB_CONTROL_SETUP_PACKET_INIT_CLASS Die WDF_USB_CONTROL_SETUP_PACKET_INIT_CLASS-Funktion initialisiert eine WDF_USB_CONTROL_SETUP_PACKET-Struktur für eine geräteklassenspezifische USB-Steuerungsübertragung.
WDF_USB_CONTROL_SETUP_PACKET_INIT_FEATURE Die WDF_USB_CONTROL_SETUP_PACKET_INIT_FEATURE-Funktion initialisiert eine WDF_USB_CONTROL_SETUP_PACKET-Struktur für eine USB-Steuerungsübertragung, die ein Gerätefeature festlegt oder löscht.
WDF_USB_CONTROL_SETUP_PACKET_INIT_GET_STATUS Die WDF_USB_CONTROL_SETUP_PACKET_INIT_GET_STATUS-Funktion initialisiert eine WDF_USB_CONTROL_SETUP_PACKET-Struktur für eine USB-Steuerungsübertragung, die geräte-status abruft.
WDF_USB_CONTROL_SETUP_PACKET_INIT_VENDOR Die WDF_USB_CONTROL_SETUP_PACKET_INIT_VENDOR-Funktion initialisiert eine WDF_USB_CONTROL_SETUP_PACKET-Struktur für eine herstellerspezifische USB-Steuerungsübertragung.
WDF_USB_DEVICE_CREATE_CONFIG_INIT Die WDF_USB_DEVICE_CREATE_CONFIG_INIT-Funktion initialisiert eine WDF_USB_DEVICE_CREATE_CONFIG-Struktur.
WDF_USB_DEVICE_INFORMATION_INIT Die WDF_USB_DEVICE_INFORMATION_INIT-Funktion initialisiert die WDF_USB_DEVICE_INFORMATION Struktur eines Treibers.
WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_DECONFIG Die WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_DECONFIG-Funktion initialisiert eine WDF_USB_DEVICE_SELECT_CONFIG_PARAMS-Struktur, sodass ein Treiber ein USB-Gerät dekonfigurieren kann.
WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_INTERFACES_DESCRIPTORS Die WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_INTERFACES_DESCRIPTORS-Funktion initialisiert eine WDF_USB_DEVICE_SELECT_CONFIG_PARAMS-Struktur, sodass ein Treiber eine Konfiguration mithilfe von USB-Deskriptoren angeben kann.
WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_MULTIPLE_INTERFACES Die WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_MULTIPLE_INTERFACES-Funktion initialisiert eine WDF_USB_DEVICE_SELECT_CONFIG_PARAMS-Struktur, sodass ein Treiber ein Gerät für die Verwendung mehrerer Schnittstellen konfigurieren kann.
WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_SINGLE_INTERFACE Die WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_SINGLE_INTERFACE-Funktion initialisiert eine WDF_USB_DEVICE_SELECT_CONFIG_PARAMS-Struktur, sodass ein Treiber ein Gerät für die Verwendung einer einzelnen angegebenen Schnittstelle konfigurieren kann.
WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_URB Die WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_URB-Funktion initialisiert eine WDF_USB_DEVICE_SELECT_CONFIG_PARAMS-Struktur, sodass ein Treiber eine Konfiguration mithilfe einer URB angeben kann.
WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR Die WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR-Funktion initialisiert eine WDF_USB_INTERFACE_SELECT_SETTING_PARAMS-Struktur, sodass ein Treiber eine USB-Schnittstelle auswählen kann, indem er einen Schnittstellendeskriptor angibt.
WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_SETTING Die WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_SETTING-Funktion initialisiert eine WDF_USB_INTERFACE_SELECT_SETTING_PARAMS-Struktur, sodass ein Treiber eine USB-Schnittstelle auswählen kann, indem er ein Handle für ein Schnittstellenobjekt und eine alternative Einstellung für die Schnittstelle angibt.
WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB Die WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB-Funktion initialisiert eine WDF_USB_INTERFACE_SELECT_SETTING_PARAMS-Struktur, sodass ein Treiber eine USB-Schnittstelle auswählen kann, indem er eine URB angibt.
WDF_USB_PIPE_DIRECTION_IN Die WDF_USB_PIPE_DIRECTION_IN-Funktion bestimmt, ob ein angegebener USB-Endpunkt ein Eingabeendpunkt ist.
WDF_USB_PIPE_DIRECTION_OUT Die WDF_USB_PIPE_DIRECTION_OUT-Funktion bestimmt, ob ein angegebener USB-Endpunkt ein Ausgabeendpunkt ist.
WDF_USB_PIPE_INFORMATION_INIT Die WDF_USB_PIPE_INFORMATION_INIT-Funktion initialisiert eine WDF_USB_PIPE_INFORMATION-Struktur.
WdfUsbInterfaceGetConfiguredPipe Die WdfUsbInterfaceGetConfiguredPipe-Methode gibt ein Handle an das Framework-Pipe-Objekt zurück, das einer angegebenen USB-Geräteschnittstelle und einem angegebenen Pipeindex zugeordnet ist. Optional gibt die Methode auch Informationen zur Pipe zurück.
WdfUsbInterfaceGetConfiguredSettingIndex Die WdfUsbInterfaceGetConfiguredSettingIndex-Methode gibt den Alternativen Einstellungsindex zurück, der derzeit für eine angegebene USB-Geräteschnittstelle ausgewählt ist.
WdfUsbInterfaceGetDescriptor Die WdfUsbInterfaceGetDescriptor-Methode ruft den USB-Schnittstellendeskriptor ab, der einer angegebenen alternativen Einstellung einer angegebenen USB-Schnittstelle zugeordnet ist.
WdfUsbInterfaceGetEndpointInformation Die WdfUsbInterfaceGetEndpointInformation-Methode ruft Informationen zu einem angegebenen USB-Geräteendpunkt und der zugehörigen Pipe ab.
WdfUsbInterfaceGetInterfaceNumber Die WdfUsbInterfaceGetInterfaceNumber-Methode gibt die Schnittstellennummer eines angegebenen USB-Schnittstellenobjekts zurück.
WdfUsbInterfaceGetNumConfiguredPipes Die WdfUsbInterfaceGetNumConfiguredPipes-Methode gibt die Anzahl der Pipes zurück, die für eine angegebene USB-Geräteschnittstelle konfiguriert sind.
WdfUsbInterfaceGetNumEndpoints Die WdfUsbInterfaceGetNumEndpoints-Methode gibt die Anzahl von Endpunkten zurück, die einer angegebenen alternativen Einstellung einer angegebenen USB-Schnittstelle zugeordnet sind.
WdfUsbInterfaceGetNumSettings Die WdfUsbInterfaceGetNumSettings-Methode gibt die Anzahl alternativer Einstellungen zurück, die von einer angegebenen USB-Schnittstelle unterstützt werden.
WdfUsbInterfaceSelectSetting Die WdfUsbInterfaceSelectSetting-Methode wählt eine angegebene alternative Einstellung für eine angegebene USB-Schnittstelle aus.
WdfUsbTargetDeviceAllocAndQueryString Die WdfUsbTargetDeviceAllocAndQueryString-Methode weist einen Puffer zu, und ruft dann die Unicode-Zeichenfolge ab, die einem angegebenen USB-Gerät und einem angegebenen Deskriptorindexwert zugeordnet ist.
WdfUsbTargetDeviceCreate Die WdfUsbTargetDeviceCreate-Methode erstellt ein Framework-USB-Geräteobjekt für ein angegebenes Frameworkgeräteobjekt und öffnet das USB-Gerät für E/A-Vorgänge.
WdfUsbTargetDeviceCreateIsochUrb Die WdfUsbTargetDeviceCreateIsochUrb-Methode weist einen isochronen USB-Anforderungsblock (URB) zu.
WdfUsbTargetDeviceCreateUrb Die WdfUsbTargetDeviceCreateUrb-Methode weist einen USB-Anforderungsblock (URB) zu.
WdfUsbTargetDeviceCreateWithParameters Die WdfUsbTargetDeviceCreateWithParameters-Methode erstellt ein Framework-USB-Geräteobjekt für ein angegebenes Frameworkgeräteobjekt und öffnet das USB-Gerät für E/A-Vorgänge.
WdfUsbTargetDeviceCyclePortSynchronously Die WdfUsbTargetDeviceCyclePortSynchronously-Methode schaltet den USB-Anschluss ein, an den ein angegebenes Gerät angeschlossen ist.
WdfUsbTargetDeviceFormatRequestForControlTransfer Die WdfUsbTargetDeviceFormatRequestForControlTransfer-Methode erstellt eine USB-Steuerelementübertragungsanforderung, sendet die Anforderung jedoch nicht.
WdfUsbTargetDeviceFormatRequestForCyclePort Die WdfUsbTargetDeviceFormatRequestForCyclePort-Methode erstellt eine Power-Cycle-Anforderung für den Port, an den ein angegebenes Gerät angefügt ist. Die Anforderung wird jedoch nicht gesendet.
WdfUsbTargetDeviceFormatRequestForString Die WdfUsbTargetDeviceFormatRequestForString-Methode erstellt eine Anforderung für den USB-Zeichenfolgendeskriptor, der dem Zeichenfolgenindexwert eines USB-Geräts zugeordnet ist.
WdfUsbTargetDeviceFormatRequestForUrb Die WdfUsbTargetDeviceFormatRequestForUrb-Methode erstellt eine USB-Anforderung für ein angegebenes USB-Gerät unter Verwendung von Anforderungsparametern, die von einer URB beschrieben werden, aber die Anforderung wird nicht gesendet.
WdfUsbTargetDeviceGetDeviceDescriptor Die WdfUsbTargetDeviceGetDeviceDescriptor-Methode ruft den USB-Gerätedeskriptor für das USB-Gerät ab, das einem angegebenen Framework-USB-Geräteobjekt zugeordnet ist.
WdfUsbTargetDeviceGetInterface Die WdfUsbTargetDeviceGetInterface-Methode gibt ein Handle für das Framework-USB-Schnittstellenobjekt zurück, das einem angegebenen Schnittstellenindex zugeordnet ist.
WdfUsbTargetDeviceGetIoTarget Die WdfUsbTargetDeviceGetIoTarget-Methode gibt ein Handle an das E/A-Zielobjekt zurück, das einem angegebenen USB-Gerät zugeordnet ist.
WdfUsbTargetDeviceGetNumInterfaces Die WdfUsbTargetDeviceGetNumInterfaces-Methode gibt die Anzahl der USB-Geräteschnittstellen zurück, die von einem angegebenen USB-Gerät unterstützt werden.
WdfUsbTargetDeviceIsConnectedSynchronous Die WdfUsbTargetDeviceIsConnectedSynchronous-Methode bestimmt, ob das angegebene USB-Gerät angeschlossen ist.
WdfUsbTargetDeviceQueryString Die WdfUsbTargetDeviceQueryString-Methode ruft die Unicode-Zeichenfolge ab, die einem angegebenen USB-Gerät und einem angegebenen Deskriptorindexwert zugeordnet ist.
WdfUsbTargetDeviceQueryUsbCapability Die WdfUsbTargetDeviceQueryUsbCapability-Methode bestimmt, ob der Hostcontroller und der USB-Treiberstapel eine bestimmte Funktion unterstützen.
WdfUsbTargetDeviceResetPortSynchronously Die WdfUsbTargetDeviceResetPortSynchronously-Methode setzt den USB-Anschluss zurück, der dem angegebenen USB-Gerät zugeordnet ist.
WdfUsbTargetDeviceRetrieveConfigDescriptor Die WdfUsbTargetDeviceRetrieveConfigDescriptor-Methode ruft den USB-Konfigurationsdeskriptor für das USB-Gerät ab, das einem angegebenen USB-Framework-Geräteobjekt zugeordnet ist.
WdfUsbTargetDeviceRetrieveCurrentFrameNumber Die WdfUsbTargetDeviceRetrieveCurrentFrameNumber-Methode ruft die aktuelle USB-Framenummer ab.
WdfUsbTargetDeviceRetrieveInformation Die WdfUsbTargetDeviceRetrieveInformation-Methode ruft Informationen zu dem USB-Gerät ab, das einem angegebenen USB-Framework-Geräteobjekt zugeordnet ist.
WdfUsbTargetDeviceSelectConfig Die WdfUsbTargetDeviceSelectConfig-Methode wählt eine USB-Konfiguration für ein Gerät aus oder dekonfiguriert das Gerät.
WdfUsbTargetDeviceSendControlTransferSynchronously Die WdfUsbTargetDeviceSendControlTransferSynchronously-Methode erstellt eine USB-Steuerungsübertragungsanforderung und sendet sie synchron an ein E/A-Ziel.
WdfUsbTargetDeviceSendUrbSynchronously Die WdfUsbTargetDeviceSendUrbSynchronously-Methode sendet eine USB-Anforderung synchron an ein angegebenes USB-Gerät unter Verwendung von Anforderungsparametern, die durch eine URB beschrieben werden.
WdfUsbTargetDeviceWdmGetConfigurationHandle Die WdfUsbTargetDeviceWdmGetConfigurationHandle-Methode gibt das USBD_CONFIGURATION_HANDLE typisierte Handle zurück, das der aktuellen Konfiguration eines angegebenen USB-Geräts zugeordnet ist.
WdfUsbTargetPipeAbortSynchronously Die WdfUsbTargetPipeAbortSynchronously-Methode erstellt eine Abbruchanforderung und sendet sie synchron an eine angegebene USB-Pipe.
WdfUsbTargetPipeConfigContinuousReader Die WdfUsbTargetPipeConfigContinuousReader-Methode konfiguriert das Framework so, dass kontinuierlich aus einer angegebenen USB-Pipe gelesen wird.
WdfUsbTargetPipeFormatRequestForAbort Die WdfUsbTargetPipeFormatRequestForAbort-Methode erstellt eine Abbruchanforderung für eine angegebene USB-Pipe, sendet die Anforderung jedoch nicht.
WdfUsbTargetPipeFormatRequestForRead Die WdfUsbTargetPipeFormatRequestForRead-Methode erstellt eine Leseanforderung für eine USB-Eingabepipe, sendet die Anforderung jedoch nicht.
WdfUsbTargetPipeFormatRequestForReset Die WdfUsbTargetPipeFormatRequestForReset-Methode erstellt eine Zurücksetzungsanforderung für eine angegebene USB-Pipe, sendet die Anforderung jedoch nicht.
WdfUsbTargetPipeFormatRequestForUrb Die WdfUsbTargetPipeFormatRequestForUrb-Methode erstellt eine USB-Anforderung für eine angegebene USB-Pipe mithilfe von Anforderungsparametern, die von einem angegebenen URB beschrieben werden, aber die Anforderung wird nicht gesendet.
WdfUsbTargetPipeFormatRequestForWrite Die WdfUsbTargetPipeFormatRequestForWrite-Methode erstellt eine Schreibanforderung für eine USB-Ausgabepipe, sendet die Anforderung jedoch nicht.
WdfUsbTargetPipeGetInformation Die WdfUsbTargetPipeGetInformation-Methode ruft Informationen zu einer USB-Pipe und ihrem Endpunkt ab.
WdfUsbTargetPipeGetIoTarget Die WdfUsbTargetPipeGetIoTarget-Methode gibt ein Handle an das E/A-Zielobjekt zurück, das einer angegebenen USB-Pipe zugeordnet ist.
WdfUsbTargetPipeGetType Die WdfUsbTargetPipeGetType-Methode gibt den Typ einer angegebenen USB-Pipe zurück.
WdfUsbTargetPipeIsInEndpoint Die WdfUsbTargetPipeIsInEndpoint-Methode bestimmt, ob eine angegebene USB-Pipe mit einem Eingabeendpunkt verbunden ist.
WdfUsbTargetPipeIsOutEndpoint Die WdfUsbTargetPipeIsOutEndpoint-Methode bestimmt, ob eine angegebene USB-Pipe mit einem Ausgabeendpunkt verbunden ist.
WdfUsbTargetPipeReadSynchronously Die WdfUsbTargetPipeReadSynchronously-Methode erstellt eine Leseanforderung und sendet sie synchron an eine angegebene USB-Eingabepipe.
WdfUsbTargetPipeResetSynchronously Die WdfUsbTargetPipeResetSynchronously-Methode erstellt eine Zurücksetzungsanforderung und sendet sie synchron an eine angegebene USB-Pipe.
WdfUsbTargetPipeSendUrbSynchronously Die WdfUsbTargetPipeSendUrbSynchronously-Methode erstellt eine USB-Anforderung für eine angegebene USB-Pipe unter Verwendung von Anforderungsparametern, die von einem angegebenen URB beschrieben werden.
WdfUsbTargetPipeSetNoMaximumPacketSizeCheck Die WdfUsbTargetPipeSetNoMaximumPacketSizeCheck-Methode deaktiviert den Test des Frameworks, ob die Größe des Lesepuffers eines Treibers ein Vielfaches der maximalen Paketgröße einer USB-Pipe ist.
WdfUsbTargetPipeWdmGetPipeHandle Die WdfUsbTargetPipeWdmGetPipeHandle-Methode gibt das USBD_PIPE_HANDLE typisierte Handle zurück, das einem angegebenen Frameworkpipeobjekt zugeordnet ist.
WdfUsbTargetPipeWriteSynchronously Die WdfUsbTargetPipeWriteSynchronously-Methode erstellt eine Schreibanforderung und sendet sie synchron an eine angegebene USB-Ausgabepipe.

Rückruffunktionen

EVT_WDF_USB_READER_COMPLETION_ROUTINE Die EvtUsbTargetPipeReadComplete-Ereignisrückruffunktion eines Treibers informiert den Treiber darüber, dass ein fortlaufender Reader eine Leseanforderung erfolgreich abgeschlossen hat.
EVT_WDF_USB_READERS_FAILED Die Ereignisrückruffunktion EvtUsbTargetPipeReadersFailed eines Treibers informiert den Treiber darüber, dass ein fortlaufender Reader beim Verarbeiten einer Leseanforderung einen Fehler gemeldet hat.

Strukturen

WDF_USB_CONTINUOUS_READER_CONFIG Die WDF_USB_CONTINUOUS_READER_CONFIG-Struktur enthält Informationen, die das Framework verwendet, um einen fortlaufenden Reader für eine USB-Pipe zu konfigurieren.
WDF_USB_CONTROL_SETUP_PACKET Die WDF_USB_CONTROL_SETUP_PACKET-Struktur beschreibt ein Setuppaket für eine USB-Steuerübertragung.
WDF_USB_DEVICE_CREATE_CONFIG Die WDF_USB_DEVICE_CREATE_CONFIG-Struktur enthält Informationen, die das Framework zum Konfigurieren eines Framework-USB-Geräteobjekts verwendet.
WDF_USB_DEVICE_INFORMATION Die WDF_USB_DEVICE_INFORMATION-Struktur enthält Versions- und Funktionsinformationen für ein USB-Gerät.
WDF_USB_DEVICE_SELECT_CONFIG_PARAMS Die WDF_USB_DEVICE_SELECT_CONFIG_PARAMS-Struktur gibt USB-Gerätekonfigurationsparameter an.
WDF_USB_INTERFACE_SELECT_SETTING_PARAMS Die WDF_USB_INTERFACE_SELECT_SETTING_PARAMS-Struktur enthält Auswahlinformationen für eine USB-Schnittstelle.
WDF_USB_INTERFACE_SETTING_PAIR Die WDF_USB_INTERFACE_SETTING_PAIR-Struktur gibt eine alternative Einstellung für eine angegebene USB-Schnittstelle an.
WDF_USB_PIPE_INFORMATION Die WDF_USB_PIPE_INFORMATION-Struktur enthält Informationen zu einer USB-Pipe und ihrem Endpunkt.
WDF_USB_REQUEST_COMPLETION_PARAMS Die WDF_USB_REQUEST_COMPLETION_PARAMS-Struktur enthält Parameter, die dem Abschluss einer E/A-Anforderung für ein USB-Gerät zugeordnet sind.

Enumerationen

WDF_USB_BMREQUEST_DIRECTION Die WDF_USB_BMREQUEST_DIRECTION-Enumeration gibt die Datenübertragungsrichtung für eine USB-Steuerübertragung an.
WDF_USB_BMREQUEST_RECIPIENT Die WDF_USB_BMREQUEST_RECIPIENT-Enumeration identifiziert den Empfänger der Datenübertragung für eine USB-Steuerübertragung.
WDF_USB_BMREQUEST_TYPE Die WDF_USB_BMREQUEST_TYPE-Enumeration gibt den Datenübertragungstyp für eine USB-Steuerübertragung an.
WDF_USB_DEVICE_TRAITS Die WDF_USB_DEVICE_TRAITS-Enumeration identifiziert USB-Gerätemerkmale.
WDF_USB_PIPE_TYPE Die WDF_USB_PIPE_TYPE-Enumeration identifiziert die Typen von USB-Pipes.
WDF_USB_REQUEST_TYPE Die WDF_USB_REQUEST_TYPE-Enumeration identifiziert die Typen von USB-Anforderungen, die ein frameworkbasierter Treiber an ein USB-E/A-Ziel senden kann.
WdfUsbTargetDeviceSelectConfigType Die WdfUsbTargetDeviceSelectConfigType-Enumeration definiert Typen von Konfigurationsvorgängen für USB-Geräte.
WdfUsbTargetDeviceSelectSettingType Die WdfUsbTargetDeviceSelectSettingType-Enumeration definiert Techniken zum Angeben einer alternativen Einstellung für eine USB-Schnittstelle.