IOCTL_MIPI_DSI_RESET IOCTL (ntddvdeo.h)

项目
03/05/2024

IOCTL_MIPI_DSI_RESET 请求在图形驱动程序和 OS 控制下重置设备。

主要代码

IRP_MJ_DEVICE_CONTROL

输入缓冲区

N/A

输入缓冲区长度

N/A

输出缓冲区

N/A

输出缓冲区长度

N/A

输入/输出缓冲区

DXGK_DSI_RESET结构。

输入/输出缓冲区长度

至少 sizeof(DXGK_DSI_RESET)

状态块

如果请求成功，Irp-IoStatus.Status> 设置为 STATUS_SUCCESS。否则，状态为相应的错误条件作为 NTSTATUS 代码。

有关详细信息，请参阅 NTSTATUS 值。

注解

移动行业处理器接口 (MIPI) 数字串行接口 (DSI) IOCTL 必须由监视器、oem 面板或端口/微型端口驱动程序处理。

如果 OEM 面板驱动程序检测到面板处于错误状态，则应发送 IOCTL_MIPI_DSI_RESET 请求在图形驱动程序和 OS 控制下重置设备。 OS 将与图形驱动程序协调重置。重置是一项重量级操作，会导致多个帧的显示空白，因此应仅用作最后手段。

正常面板操作在处理重置时无法继续，因此 OS 将处理类似于显示模式更改、刷新挂起的 GPU 活动（包括任何翻转）以及阻止新工作，直到完成。 OS 将 IOCTL 转换为 DsiReset DDI 调用。驱动程序应完全从面板上拔下电源，并从头开始重新初始化它，并在适当的延迟后执行它所需的任何操作，以便在返回之前将面板还原到可行的状态。设置 后，SecondaryPort 标志指示重置应面向辅助面板，而不是主要面板。

如果图形驱动程序需要完整模式集才能从面板重置执行或还原，则应设置输出标志 NeedModeSet。如果在从调用返回时设置，OS 将在取消阻止正常活动之前使用 DxgkDdiSetTimingsFromVidPn 调用进行响应。如果需要，驱动程序可以选择将一些重置工作推迟到此调用，前提是在设置计时调用之后应处于可工作状态。

图形驱动程序应报告驱动程序通过 MipiErrors 输出字段检测到且未处理的任何低级别 MIPI 错误。

如果在重置期间发生不可恢复的错误，图形驱动程序应设置 ResetFailed 输出标志。这预计将是灾难性的失败。图形驱动程序还应通过使用 DxgkCbIndicateConnectorChange 回调指示已拔出电源，然后通过报告已失败的目标的 TargetStatusDisconnect 来响应 DxgkDdiQueryConnectionChange，从而发出目标上没有可用的显示信号。

输出字段将传播回 IOCTL 的输出缓冲区。