DXGKDDI_DISCONNECTDOORBELL回呼函式（d3dkmddi.h）

重要

某些資訊與發行前版本產品有關，在發行前版本產品可能經過大幅修改。 Microsoft未就此處提供的資訊提供任何明示或默示擔保。

DxgkDdiDisconnectDoorbell 函式會中斷先前連線的門鈴與硬體佇列的連線。

語法

DXGKDDI_DISCONNECTDOORBELL DxgkddiDisconnectdoorbell;

NTSTATUS DxgkddiDisconnectdoorbell(
  INOUT_PDXGKARG_DISCONNECTDOORBELL pArgs
)
{...}

pArgs

[in/out]描述要中斷連線之門鈴之 DXGKARG_DISCONNECTDOORBELL 結構的指標。

DxgkDdiDisconnectDoorbell 必須成功並傳回STATUS_SUCCESS。

OS 會呼叫 DxgkDdiDisconnectDoorbell，以取消對應指派給此門鈴的實體門鈴位置。 KMD 應中斷硬體佇列、門鈴實體位址和引擎等的連線。實體門鈴位置可以指派給一些其他邏輯門鈴物件。

KMD 不應終結或釋放與 hDoorbell 相關聯的任何其他物件，因為門鈴物件未被終結，而且可以在稍後重新連線。

從這個 DDI 呼叫傳回時，Dxgkrnl 會執行下列步驟來中斷門鈴的連線：

將使用者模式 DoorbellCpuVirtualAddress 旋轉至虛擬頁面，讓 UMD 無法再寫入實體門鈴位置。
將 D3DDDI_DOORBELL_STATUS_DISCONNECTED_RETRY 寫入 DoorbellStatusCpuVirtualAddress，讓 UMD 知道門鈴已中斷連線。

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