IOCTL_UCMTCPCI_PORT_CONTROLLER_GET_STATUS IOCTL (ucmtcpciportcontrollerrequests.h)

Artikel
2025-02-07

Ruft Die Werte aller Statusregister gemäß der Spezifikation des universal serial Bus Type-C Port Controller Interface Specification ab. Der Clienttreiber muss die Werte der CC_STATUS, POWER_STATUS und FAULT_STATUS Register abrufen.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Ein Zeiger auf eine UCMTCPCI_PORT_CONTROLLER_GET_STATUS_IN_PARAMS Struktur, die alle Registerwerte des Steuerelements enthält. Rufen Sie zum Abrufen der Struktur WdfRequestRetrieveInputBuffer auf, indem Sie das empfangene Framework-Anforderungsobjekt übergeben.

Eingabepufferlänge

Die Größe der UCMTCPCI_PORT_CONTROLLER_GET_STATUS_IN_PARAMS Struktur.

Ausgabepuffer

Ein Zeiger auf die UCMTCPCI_PORT_CONTROLLER_GET_STATUS_OUT_PARAMS Struktur. Rufen Sie zum Abrufen der Struktur WdfRequestRetrieveOutputBuffer auf, indem Sie das empfangene Framework-Anforderungsobjekt übergeben.

Länge des Ausgabepuffers

Die Größe der UCMTCPCI_PORT_CONTROLLER_GET_STATUS_OUT_PARAMS Struktur.

Statusblock

Irp->IoStatus.Status auf STATUS_SUCCESS festgelegt ist, wenn die Anforderung erfolgreich ist. Andernfalls Status der entsprechenden Fehlerbedingung als NTSTATUS- Code.

Bemerkungen

Die UcmTcpciCx-Klassenerweiterung sendet diese IOCTL-Anforderung, um die Werte der Statusregister abzurufen. Der Clienttreiber muss mit dem Portcontroller kommunizieren, um die Registerwerte abzurufen und die empfangene UCMTCPCI_PORT_CONTROLLER_GET_STATUS_OUT_PARAMS Struktur mit diesen Werten aufzufüllen. Um die Anforderung abzuschließen, muss der Treiber die aufgefüllte Struktur für das Framework-Anforderungsobjekt festlegen, indem WdfRequestSetInformation aufgerufen und dann WdfRequestComplete- aufgerufen wird, um die Anforderung abzuschließen.