IOCTL_UCMTCPCI_PORT_CONTROLLER_GET_STATUS IOCTL (ucmtcpciportcontrollerrequests.h)

Artículo
08/07/2023

Obtiene los valores de todos los registros de estado según la especificación de interfaz del controlador de puerto de tipo C del bus serie universal. El controlador cliente debe recuperar los valores de los registros de CC_STATUS, POWER_STATUS y FAULT_STATUS.

Código principal

IRP_MJ_DEVICE_CONTROL

Búfer de entrada

Puntero a una estructura UCMTCPCI_PORT_CONTROLLER_GET_STATUS_IN_PARAMS que contiene todos los valores de registro de control. Para obtener la estructura, llame a WdfRequestRetrieveInputBuffer pasando el objeto de solicitud de marco recibido.

Longitud del búfer de entrada

Tamaño de la estructura UCMTCPCI_PORT_CONTROLLER_GET_STATUS_IN_PARAMS .

Búfer de salida

Puntero a la estructura UCMTCPCI_PORT_CONTROLLER_GET_STATUS_OUT_PARAMS . Para obtener la estructura, llame a WdfRequestRetrieveOutputBuffer pasando el objeto de solicitud del marco recibido.

Longitud del búfer de salida

Tamaño de la estructura UCMTCPCI_PORT_CONTROLLER_GET_STATUS_OUT_PARAMS .

Bloque de estado

Irp->IoStatus.Status se establece en STATUS_SUCCESS si la solicitud se realiza correctamente. De lo contrario, estado de la condición de error adecuada como código NTSTATUS .

Comentarios

La extensión de clase UcmTcpciCx envía esta solicitud IOCTL para recuperar los valores de los registros de estado. El controlador de cliente debe comunicarse con el controlador de puerto para recuperar los valores de registro y rellenar la estructura de UCMTCPCI_PORT_CONTROLLER_GET_STATUS_OUT_PARAMS recibida con esos valores. Para completar la solicitud, el controlador debe establecer la estructura rellenada en el objeto de solicitud de marco llamando a WdfRequestSetInformation y, a continuación, llamar a WdfRequestComplete para completar la solicitud.