IOCTL_UCMTCPCI_PORT_CONTROLLER_GET_CONTROL IOCTL (ucmtcpciportcontrollerrequests.h)

Artikel
02/27/2024

Ruft die Werte aller Steuerelementregister ab, die gemäß der Schnittstellenspezifikation für den Universal Serial Bus Typ-C definiert sind.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Ein Zeiger auf eine UCMTCPCI_PORT_CONTROLLER_GET_CONTROL_IN_PARAMS-Struktur , die alle Steuerelementregisterwerte enthält. Rufen Sie zum Abrufen der Struktur WdfRequestRetrieveInputBuffer auf, indem Sie das empfangene Frameworkanforderungsobjekt übergeben.

Länge des Eingabepuffers

Die Größe der UCMTCPCI_PORT_CONTROLLER_GET_CONTROL_IN_PARAMS-Struktur .

Ausgabepuffer

Ein Zeiger auf die UCMTCPCI_PORT_CONTROLLER_GET_CONTROL_OUT_PARAMS-Struktur . Rufen Sie zum Abrufen der Struktur WdfRequestRetrieveOutputBuffer auf, indem Sie das empfangene Frameworkanforderungsobjekt übergeben.

Länge des Ausgabepuffers

Die Größe der UCMTCPCI_PORT_CONTROLLER_GET_CONTROL_OUT_PARAMS-Struktur .

Statusblock

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

Hinweise

Die UcmTcpciCx-Klassenerweiterung sendet diese IOCTL-Anforderung, um die Werte der Steuerelementregister abzurufen. Der Clienttreiber muss mit dem Portcontroller kommunizieren, um die Werte für POWER_CONTROL, ROLE_CONTROL, TCPC_CONTROL und FAULT_CONTROL Register abzurufen und die empfangene UCMTCPCI_PORT_CONTROLLER_GET_CONTROL_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.