DXGKCB_DISCONNECTDOORBELL回呼函式 (d3dkmddi.h)

KMD 會呼叫 DxgkCbDisconnectDoorbell ，通知 Dxgkrnl KMD 必須中斷先前連線門鈴與硬體佇列的連線。

語法

DXGKCB_DISCONNECTDOORBELL DxgkcbDisconnectdoorbell;

NTSTATUS DxgkcbDisconnectdoorbell(
  INOUT_PDXGKARGCB_DISCONNECTDOORBELL pArgs
)
{...}

參數

pArgs

[in]描述中斷聯機之門鈴的 DXGKARGCB_DISCONNECTDOORBELL 結構的指標。

傳回值

DxgkCbDisconnectDoorbell 如果 Dxgkrnl 找不到 hHwQueue 的相關 hDoorbell，或 DisconnectReason 不是其中一個D3DDDI_DOORBELLSTATUS_DISCONNECTED_XXX 值，則會傳回STATUS_INVALID_PARAMETER。 在所有其他情況下，即使門鈴已中斷連線，此函式仍會成功。

備註

KMD 會呼叫此函式，以在需要中斷門鈴連線時通知 Dxgkrnl 。 KMD 應該考慮只有在從這個回呼傳回之後，才會中斷連線的實體門鈴位址。

Dxgkrnl 會取消對應虛擬位址，並將門鈴標示為已中斷連線。 具體而言， Dxgkrnl 會執行下列步驟來中斷門鈴的連線：

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

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

規格需求

另請參閱

DXGKARGCB_DISCONNECTDOORBELL

DxgkDdiConnectDoorbell