Share via

WinUsb_RegisterIsochBuffer-Funktion (winusb.h)

  • Artikel

Die WinUsb_RegisterIsochBuffer-Funktion registriert einen Puffer, der für isochrone Übertragungen verwendet werden soll.

Syntax

BOOL WinUsb_RegisterIsochBuffer(
  [in]  WINUSB_INTERFACE_HANDLE     InterfaceHandle,
  [in]  UCHAR                       PipeID,
  [in]  PUCHAR                      Buffer,
  [in]  ULONG                       BufferLength,
  [out] PWINUSB_ISOCH_BUFFER_HANDLE IsochBufferHandle
);

Parameter

[in] InterfaceHandle

Ein undurchsichtiges Handle für eine Schnittstelle in der ausgewählten Konfiguration. Dieses Handle muss durch einen vorherigen Aufruf von WinUsb_Initialize oder WinUsb_GetAssociatedInterface erstellt werden.

[in] PipeID

Abgeleitet von Bit 3...0 des Felds bEndpointAddress im Endpunktdeskriptor.

[in] Buffer

Zeiger auf den zu registrierenden Übertragungspuffer.

[in] BufferLength

Länge des Übertragungspuffers in Byte, auf den der Puffer verweist.

[out] IsochBufferHandle

Empfängt ein undurchsichtiges Handle für den registrierten Puffer. Dieses Handle ist für andere WinUSB-Funktionen erforderlich, die isochrone Übertragungen durchführen. Rufen Sie die Funktion WinUsb_UnregisterIsochBuffer auf, um das Handle freizugeben.

Rückgabewert

WinUsb_RegisterIsochBuffer gibt TRUE zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Funktion FALSE zurück, und der Aufrufer kann den protokollierten Fehler durch Aufrufen von GetLastError abrufen.

Wenn der Aufrufer ContinueStream auf TRUE festlegt, schlägt die Übertragung fehl, wenn Winusb.sys die Übertragung nicht so planen kann, dass der Stream fortgesetzt wird, ohne einen oder mehrere Frames zu löschen.

Hinweise

Vor dem Initiieren isochroner Übertragungen an oder aus einem Puffer muss der Aufrufer den Puffer bei WinUsb_RegisterIsochBuffer registrieren. Dieser Aufruf ermöglicht es dem Winusb.sys, den Puffer vorab zuzuordnen und nach für alle nachfolgenden Übertragungen mithilfe des Puffers zu sperren.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8.1
Unterstützte Mindestversion (Server) Windows Server 2012 R2
Zielplattform Universell
Header winusb.h (winusb.h einschließen)
Bibliothek Winusb.lib
DLL Winusb.dll

Weitere Informationen

Senden isochroner USB-Übertragungen von einer WinUSB-Desktop-App

WinUSB-Funktionen

WinUsb_UnregisterIsochBuffer