Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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.
D3DKMTDestroyDoorbell destroys a doorbell.
Syntax
NTSTATUS D3DKMTDestroyDoorbell(
D3DKMT_DESTROY_DOORBELL *unnamedParam1
);
Parameters
unnamedParam1
[in] Pointer to a D3DKMT_DESTROY_DOORBELL structure that identifies the hardware queue whose doorbell is to be destroyed.
Return value
D3DKMTDestroyDoorbell returns STATUS_SUCCESS when the OS successfully destroys the doorbell object. If hDoorbell points to a valid doorbell, then this call always succeeds; otherwise it returns STATUS_INVALID_PARAMETER.
Remarks
When UMD calls D3DKMTDestroyDoorbell, the OS does the following:
- Removes its reference to hRingBuffer and to hRingBufferControl allocations belonging to this doorbell.
- Frees the mapping that DoorbellStatusCPUVirtualAddress points to.
- Frees both the user-mode and kernel-mode mappings that DoorbellCPUVirtuslAddress points to.
- Calls KMD's [DxgkDdiDestroyDoorbell] so that KMD can disconnect the physical doorbell location and destroy its doorbell objects.
The UMD must not use the handle after calling D3DKMTDestroyDoorbell.
For more information, see User-mode work submission.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 11, version 24H2 (WDDM 3.2) |
| Header | d3dkmthk.h |