IOCTL_GENERICUSBFN_GET_INTERFACE_DESCRIPTOR_SET IOCTL (genericusbfnioctl.h)

Dieser E/A-Steuercode (IOCTL) wird von einem Benutzermodusdienst oder einer Anwendung gesendet, um den gesamten USB-Schnittstellendeskriptor (Universal Serial Bus) für eine Funktion auf dem Gerät festzulegen.

Hinweis Diese IOCTL-Anforderung ruft nicht den Schnittstellendeskriptor ab, der für das gesamte Gerät festgelegt ist.

 

Eingabepuffer

Ein Zeiger auf eine USBFN_INTERFACE_INFO-Struktur .

Länge des Eingabepuffers

Die Größe einer USBFN_INTERFACE_INFO-Struktur .

Ausgabepuffer

Ein Zeiger auf einen Puffer, der eine USBFN_INTERFACE_INFO-Struktur enthält. Die USB-Funktionsklassenerweiterung (UFX) füllt die Struktur mit dem gesamten Schnittstellendeskriptor auf, der einschließlich seiner Endpunktdeskriptoren festgelegt ist.

Länge des Ausgabepuffers

Die Größe eines USBFN_INTERFACE_INFO.

Hinweise

Diese Anforderung muss nach dem Senden der IOCTL_GENERICUSBFN_ACTIVATE_USB_BUS-Anforderung gesendet werden.

Die Länge des gesamten Schnittstellendeskriptors ist variabel. Der Klassentreiber muss diese IOCTL-Anforderung möglicherweise zweimal senden, um den gesamten Deskriptor festzulegen.

Wenn die Länge des gesamten Deskriptorsatzes größer als die angegebene Ausgabepufferlänge ist, legt UFX den Size-Member von USBFN_INTERFACE_INFO auf die tatsächliche Pufferlänge fest und schlägt die Anforderung mit STATUS_BUFFER_TOO_SMALL fehl. Der Treiber muss dann einen durch Size angegebenen Ausgabepuffer der Länge zuweisen und die Anforderung erneut senden.

Wenn dieser E/A-Kontrollcode (IOCTL) synchron aufgerufen wird, legen Sie den parameter lpOverlapped auf NULL fest. Wenn diese IOCTL asynchron aufgerufen wird, weisen Sie den lpOverlapped-Parameter einem Zeiger auf eine OVERLAPPED-Struktur zu, die ein Handle für ein Ereignisobjekt enthält. Die Ereignisobjekte signalisieren, wenn der Vorgang abgeschlossen ist.

Der Rückgabewert ist ein BOOL-Wert, der den Erfolg oder Fehler des Vorgangs angibt. TRUE gibt den Erfolg an, andernfalls FALSE.

Anforderungen

Anforderung	Wert
Header	genericusbfnioctl.h (include GenericUsbFnIoctl.h)

Weitere Informationen

DeviceIoControl