IOCTL_UCMTCPCI_PORT_CONTROLLER_GET_STATUS IOCTL (ucmtcpciportcontrollerrequests.h)

Artikel
03/01/2024

Ruft Die Werte aller status Register gemäß der Schnittstellenspezifikation für den Universal Serial Bus Type-C-Port-Controller 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 Steuerelementregisterwerte enthält. Um die Struktur abzurufen, rufen Sie WdfRequestRetrieveInputBuffer auf, indem Sie das empfangene Frameworkanforderungsobjekt ü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 . Um die Struktur abzurufen, rufen Sie WdfRequestRetrieveOutputBuffer auf, indem Sie das empfangene Frameworkanforderungsobjekt übergeben.

Länge des Ausgabepuffers

Die Größe der UCMTCPCI_PORT_CONTROLLER_GET_STATUS_OUT_PARAMS-Struktur .

Statusblock

Irp->IoStatus.Status ist auf STATUS_SUCCESS festgelegt, wenn die Anforderung erfolgreich ist. Andernfalls wird status für die entsprechende Fehlerbedingung als NTSTATUS-Code verwendet.

Hinweise

Die UcmTcpciCx-Klassenerweiterung sendet diese IOCTL-Anforderung, um die Werte der status-Register 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 Frameworkanforderungsobjekt festlegen, indem er WdfRequestSetInformation aufruft und dann WdfRequestComplete aufruft , um die Anforderung abzuschließen.