Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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) |