Freigeben über


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 Benutzermodus-E/A-Steuerelementanforderung. Diese Anforderung richtet sich an das USB-Hubgerät (GUID_DEVINTERFACE_USB_HUB).

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Der AssociatedIrp.SystemBuffer Member verweist auf eine vom Benutzer zugewiesene USB_NODE_CONNECTION_DRIVERKEY_NAME Struktur. Bei der Eingabe enthält das ConnectionIndex- Mitglied 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 Member der USB_NODE_CONNECTION_DRIVERKEY_NAME Struktur bei AssociatedIrp.SystemBuffer den Treiberschlüsselnamen, der dem Gerät zugeordnet ist, das mit dem Port verbunden ist, der durch ConnectionIndex-angegeben ist.

Der ActualLength Member gibt die Länge des Treiberschlüsselnamens in Bytes an. Das Parameters.DeviceIoControl.OutputBufferLength Member 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 zuweist, der groß genug ist, um alle Ausgabedaten zu enthalten, IoStatus.Information entspricht dem Wert ActualLength. Wenn der Ausgabepuffer groß genug ist, um alle Ausgabedaten zu enthalten, IoStatus.Information entspricht sizeof(USB_NODE_CONNECTION_DRIVERKEY_NAME).

Anforderungen

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

Siehe auch

USB_NODE_CONNECTION_DRIVERKEY_NAME