IOCTL_UCMTCPCI_PORT_CONTROLLER_GET_STATUS IOCTL (ucmtcpciportcontrollerrequests.h)

Статья
02/29/2024

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