IOCTL_USB_GET_NODE_CONNECTION_DRIVERKEY_NAME IOCTL (usbioctl.h)

Die IOCTL_USB_GET_NODE_CONNECTION_DRIVERKEY_NAME E/A-Steuerelementanforderung ruft den Namen des Treiberregistrierungsschlüssels ab, der dem Gerät zugeordnet ist, das mit dem angegebenen Port verbunden ist.

IOCTL_USB_GET_NODE_CONNECTION_DRIVERKEY_NAME ist eine E/A-Steuerungsanforderung im Benutzermodus. Diese Anforderung richtet sich an das USB-Hubgerät (GUID_DEVINTERFACE_USB_HUB).

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Das AssociatedIrp.SystemBuffer-Element verweist auf eine benutzerseitig zugewiesene USB_NODE_CONNECTION_DRIVERKEY_NAME-Struktur . Bei der Eingabe enthält das ConnectionIndex-Element dieser Struktur die Nummer des Ports, mit dem das Gerät verbunden ist.

Eingabepufferlänge

Die Größe einer USB_NODE_CONNECTION_DRIVERKEY_NAME-Struktur .

Ausgabepuffer

Bei der Ausgabe enthält das DriverKeyName-Element der USB_NODE_CONNECTION_DRIVERKEY_NAME-Struktur unter AssociatedIrp.SystemBuffer den Treiberschlüsselnamen, der dem Gerät zugeordnet ist, das mit dem port verbunden ist, der von ConnectionIndex angegeben wird.

Das ActualLength-Element gibt die Länge des Treiberschlüsselnamens in Bytes an. Das Parameters.DeviceIoControl.OutputBufferLength-Element gibt die Größe der gesamten USB_NODE_CONNECTION_DRIVERKEY_NAME-Struktur in Bytes an.

Länge des Ausgabepuffers

Die Größe einer USB_NODE_CONNECTION_DRIVERKEY_NAME-Struktur .

Statusblock

Der USB-Stapel legt Irp-IoStatus.Status> auf STATUS_SUCCESS fest, wenn die Anforderung erfolgreich ist. Andernfalls legt der USB-Stapel Status auf die entsprechende Fehlerbedingung fest, z. B. STATUS_INVALID_PARAMETER oder STATUS_INSUFFICIENT_RESOURCES.

Wenn der Aufrufer einen Ausgabepuffer ordnet, der groß genug ist, um alle Ausgabedaten aufzunehmen, ist IoStatus.Information gleich dem Wert von ActualLength. Wenn der Ausgabepuffer groß genug ist, um alle Ausgabedaten aufzunehmen, ist IoStatus.Information gleich sizeof(USB_NODE_CONNECTION_DRIVERKEY_NAME).

Anforderungen

Anforderung	Wert
Header	usbioctl.h (include Usbioctl.h)

Weitere Informationen

USB_NODE_CONNECTION_DRIVERKEY_NAME