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 知道門鈴已中斷連線。