IOCTL_UCMTCPCI_PORT_CONTROLLER_GET_STATUS IOCTL (ucmtcpciportcontrollerrequests.h)

Статья
2025-02-07

Возвращает значения всех регистров состояния в рамках спецификации интерфейса контроллера порта универсальной последовательной шины 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, чтобы завершить запрос.