IOCTL_MIPI_DSI_RESET IOCTL (ntd)

發行項
02/29/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 呼叫回應。驅動程式可能會視需要選擇將某些重設工作延後至此呼叫，前提是設定計時呼叫之後預期有可運作的狀態。

圖形驅動程式應該報告任何偵測到的低階MIPI錯誤，且未透過 MipiErrors 輸出字段處理驅動程式。

如果在重設期間發生無法復原的錯誤，圖形驅動程序應該設定 ResetFailed 輸出旗標。這應該是重大失敗。圖形驅動程式也應該發出訊號，指出已使用 DxgkCbIndicateConnectorChange 回呼，然後回報 TargetStatusDisconnected 針對失敗的目標回報 TargetStatusDisconnected 來回應 DxgkDdiQueryConnectionChange。

輸出欄位會傳播回 IOCTL 的輸出緩衝區。