IOCTL_UCMTCPCI_PORT_CONTROLLER_GET_STATUS IOCTL （ucmtcpciportcontrollerrequests.h）

發行項
02/07/2025

根據通用序列總線 Type-C 埠控制器介面規格，取得所有狀態緩存器的值。用戶端驅動程序必須擷取CC_STATUS、POWER_STATUS和FAULT_STATUS緩存器的值。

主要程序代碼

IRP_MJ_DEVICE_CONTROL

輸入緩衝區

包含所有控件緩存器值的 UCMTCPCI_PORT_CONTROLLER_GET_STATUS_IN_PARAMS 結構的指標。若要取得結構，請傳遞接收的架構要求物件，呼叫 WdfRequestRetrieveInputBuffer。

輸入緩衝區長度

UCMTCPCI_PORT_CONTROLLER_GET_STATUS_IN_PARAMS 結構的大小。

輸出緩衝區

UCMTCPCI_PORT_CONTROLLER_GET_STATUS_OUT_PARAMS 結構的指標。若要取得結構，請傳遞接收的架構要求物件，呼叫 WdfRequestRetrieveOutputBuffer。

輸出緩衝區長度

UCMTCPCI_PORT_CONTROLLER_GET_STATUS_OUT_PARAMS 結構的大小。

狀態區塊

如果要求成功，Irp->IoStatus.Status 會設定為STATUS_SUCCESS。否則，狀態為適當的錯誤條件，作為 NTSTATUS 程序代碼。

言論

UcmTcpciCx 類別延伸會傳送這個 IOCTL 要求，以擷取狀態快存器的值。用戶端驅動程序必須與埠控制器通訊，以擷取緩存器值，並以這些值填入收到的 UCMTCPCI_PORT_CONTROLLER_GET_STATUS_OUT_PARAMS 結構。若要完成要求，驅動程式必須在架構要求對象上設定填入的結構，方法是呼叫 WdfRequestSetInformation，然後呼叫 WdfRequestComplete 來完成要求。