USBD_GetInterfaceLength-Funktion (usbdlib.h)

  • Artikel

Die USBD_GetInterfaceLength Routine ruft die Länge eines angegebenen Schnittstellendeskriptors ab, einschließlich der Länge aller Endpunktdeskriptoren, die in der Schnittstelle enthalten sind.

Syntax

ULONG USBD_GetInterfaceLength(
  [in] PUSB_INTERFACE_DESCRIPTOR InterfaceDescriptor,
  [in] PUCHAR                    BufferEnd
);

Parameter

[in] InterfaceDescriptor

Zeiger auf einen Schnittstellendeskriptor, für den die Länge abgerufen werden soll.

[in] BufferEnd

Zeiger auf die Position innerhalb eines Puffers, an der die Suche nach der Länge der Schnittstelle und der zugehörigen Endpunkte beendet werden soll.

Rückgabewert

USBD_GetInterfaceLength gibt die Länge des Schnittstellendeskriptors und aller zugehörigen Endpunktdeskriptoren, die in der Schnittstelle enthalten sind, in Bytes zurück.

Hinweise

Aufrufer können diese Routine verwenden, um die Länge einer Schnittstelle und der zugehörigen Endpunkte abzurufen, die in einem anderen Puffer enthalten sind. Beispielsweise könnte ein Aufrufer einen Speicherort innerhalb eines größeren Puffers für InterfaceDescriptor und den Anfang eines Speicherorts eines anderen Schnittstellendeskriptors für BufferEnd angeben. Dies führt dazu, dass die Routine nur am Anfang des schnittstellendeskriptors sucht, der von InterfaceDescriptor angegeben wird, bis entweder ein anderer Schnittstellendeskriptor gefunden wird oder die durch BufferEnd angegebene Position erreicht wird.

Anforderungen

Anforderung Wert
Zielplattform Universell
Header usbdlib.h (include Usbdlib.h)
Bibliothek Usbd.lib
IRQL PASSIVE_LEVEL

Weitere Informationen

Programmierreferenz für USB-Gerätetreiber