Description

The DxgkDdiDisconnectDoorbell function disconnects a previously connected doorbell from a hardware queue.

Parameters

pArgs

[in/out] Pointer to a DXGKARG_DISCONNECTDOORBELL structure that describes the doorbell to disconnect.

Return value

DxgkDdiDisconnectDoorbell must succeed and return STATUS_SUCCESS.

Remarks

The OS calls DxgkDdiDisconnectDoorbell to unmap the physical doorbell location assigned to this doorbell. KMD should disconnect the hardware queue, doorbell physical address and engine, etc. The physical doorbell location can be assigned to some other logical doorbell object.

KMD should not destroy or free any other objects associated with hDoorbell because the doorbell object is not being destroyed and can be reconnected at a later point.

On return from this DDI call, Dxgkrnl does the following steps to disconnect the doorbell:

• Rotates the user-mode DoorbellCpuVirtualAddress to a dummy page so that UMD can no longer write to the physical doorbell location.
• Writes D3DDDI_DOORBELL_STATUS_DISCONNECTED_RETRY into DoorbellStatusCpuVirtualAddress so that UMD knows the doorbell is disconnected.

For more information, see User-mode work submission.

See also

D3DDDI_DOORBELLSTATUS

D3DKMT_CREATE_DOORBELL

DXGKARG_DISCONNECTDOORBELL

DxgkDdiConnectDoorbell

DxgkDdiDisconnectDoorbellCB