DXGKARG_CREATEDOORBELL structure (d3dkmddi.h)
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 DXGKARG_CREATEDOORBELL structure contains parameters for KMD's DxgkDdiCreateDoorbell callback function.
Syntax
typedef struct _DXGKARG_CREATEDOORBELL {
HANDLE hHwQueue;
HANDLE hDoorbell;
UINT PrivateDriverDataSize;
void *PrivateDriverData;
HANDLE hRingBuffer;
HANDLE hRingBufferControl;
DXGKARG_CREATEDOORBELL_FLAGS Flags;
} DXGKARG_CREATEDOORBELL;
Members
hHwQueue
[in] Handle to a KMD hardware queue object, which was created in a previous call to DxgkddiCreateHwQueue.
hDoorbell
[in/out] As input, contains the runtime's handle to the doorbell. KMD can store the input handle in its tracking structures. As output, when KMD finishes creating the doorbell, hDoorbell contains KMD's kernel-mode handle to the doorbell.
PrivateDriverDataSize
[in] Size, in bytes, of the driver's private data that is associated with the doorbell.
PrivateDriverData
[in/out] Pointer to the driver's private data that is associated with the doorbell.
hRingBuffer
[in] Handle to the ring buffer allocation previously created by UMD. This allocation is GPU visible and already resident. The ResizeRingBufferOperation flag is a hint from UMD to KMD that a doorbell is being recreated for this hardware queue with a new, resized ring buffer.
hRingBufferControl
[in] KMD handle to a ring buffer control allocation previously created by UMD. UMD and KMD can use this allocation as a control area to store ring buffer read/write pointer locations if required. The allocation must be GPU visible and already resident.
Flags
A bit field of DXGKARG_CREATEDOORBELL_FLAGS values specifying the doorbell creation flags.
Remarks
For more information, see User-mode work submission.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 11, version 24H2 (WDDM 3.2) |
| Header | d3dkmddi.h |