DXGKDDI_DESTROYDOORBELL callback function (d3dkmddi.h)

Article
02/22/2024

Important

Some information relates to a prerelease product which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

The DxgkDdiDestroyDoorbell function destroys a previously created doorbell object.

Syntax

DXGKDDI_DESTROYDOORBELL DxgkddiDestroydoorbell;

NTSTATUS DxgkddiDestroydoorbell(
  INOUT_PDXGKARG_DESTROYDOORBELL pArgs
)
{...}

Parameters

pArgs

[in/out] Pointer to a DXGKARG_DESTROYDOORBELL structure that describes the doorbell to destroy.

Return value

DxgkDdiDestroyDoorbell must succeed and return STATUS_SUCCESS.

Remarks

The OS calls KMD's DxgkDdiDestroyDoorbell when UMD calls D3DKMTDestroyDoorbell.

KMD should disconnect the physical doorbell location and destroy its doorbell objects.

UMD must not use the handle after calling D3DKMTDestroyDoorbell.

Requirements

Requirement	Value
Minimum supported client	WIN11_FUTURE
Header	d3dkmddi.h
IRQL	PASSIVE_LEVEL