DXGKDDI_NOTIFYWORKSUBMISSION回呼函式 (d3dkmddi.h)

DxgkDdiNotifyWorkSubmission 函式會通知 KMD UMD 已提交新工作。

語法

DXGKDDI_NOTIFYWORKSUBMISSION DxgkddiNotifyworksubmission;

NTSTATUS DxgkddiNotifyworksubmission(
  INOUT_PDXGKARG_NOTIFYWORKSUBMISSION pArgs
)
{...}

參數

pArgs

[in] DXGKARG_NOTIFYWORKSUBMISSION 結構的指標，識別提交工作所在的硬體佇列。

傳回值

DxgkDdiNotifyWorkSubmission 必須成功並傳回STATUS_SUCCESS。

備註

在使用者模式的工作提交模型中，KMD 不會涉及工作提交，因此在硬體佇列上提交新工作時通常不會察覺。 此因素是低延遲工作提交路徑的主要動機。 不過，在某些情況下，KMD 必須在硬體佇列上提交工作時收到通知。 例如，GPU 硬體排程器需要 KMD，才能在即時內容提交工作時，將硬體 Runlist 從一般切換為即時。 如果 KMD 未參與工作提交，則無法立即觸發 Runlist 參數，這會導致延遲即時工作執行。

若要解決此問題，KMD 可以在 門鈴建立時間將門鈴連線狀態指定為D3DDDI_DOORBELL_STATUS_CONNECTED_NOTIFY。 每當 UMD 看到此門鈴狀態時，它會調整其工作提交工作流程，如此一來，在撰寫新的命令並響鈴之後，它會使用 D3DKMTNotifyWorkSubmission 呼叫核心。 Dxgkrnl 會透過 DxgkDdiNotifyWorkSubmission 將此呼叫轉送到 KMD。

DxgkDdiNotifyWorkSubmission 是從 UMD 到 Dxgkrnl 到 KMD 的簡單 Ping，通知後者已在特定硬體佇列上提交新工作，因此允許 KMD 起始特定動作，例如將 Runlist 切換為即時。

KMD 也可以在建立門鈴之後動態要求通知。 如果 KMD 偵測到應該在此硬體佇列上收到工作提交通知的條件，則可以先呼叫具有狀態D3DDDI_DOORBELL_STATUS_DISCONNECTED_RETRY 的 DxgkCbDisconnectDoorbell 來中斷門鈴的連線。 稍後，當 UMD 嘗試重新連線門鈴時，KMD 可以讓連線狀態D3DDDI_DOORBELL_STATUS_CONNECTED_NOTIFY。

驅動程式應該在非常特定且不頻繁的案例中使用這項機制，因為它牽涉到每次工作提交時從 UMD 到 KMD 的來回行程，如果用於廣泛案例，則會破壞低延遲使用者模式提交模型的用途。

如需詳細資訊，請參閱 使用者模式工作提交。

規格需求

另請參閱

DXGKARG_NOTIFYWORKSUBMISSION

**DxgkDdiCreateDoorbell

DxgkCbDisconnectDoorbell