DXGKCB_SIGNALEVENT callback function (d3dkmddi.h)
A kernel-mode display driver (KMD) calls DxgkCbSignalEvent to signal an event.
Syntax
DXGKCB_SIGNALEVENT DxgkcbSignalevent;
NTSTATUS DxgkcbSignalevent(
IN_CONST_PDXGKARGCB_SIGNALEVENT unnamedParam1
)
{...}
Parameters
unnamedParam1
[in] Pointer to a DXGKARGCB_SIGNALEVENT structure that contains arguments for this call.
Return value
DxgkCbSignalEvent returns STATUS_SUCCESS if it succeeds. Otherwise, it returns one of the error codes defined in Ntstatus.h.
Remarks
The driver must call DxgkCbSignalEvent with the LastUse flag during process or device cleanup.
During paravirtualization, KMD on the host can call DxgkCbSignalEvent to signal an event created on the guest. DxgkCbSignalEvent can also be used to signal events of the host processes as well.
In the case of paravirtualization, DxgkCbSignalEvent doesn't signal the event synchronously, so the event isn't signaled when the callback returns. Otherwise, the event is signaled synchronously.
The IRQL for DxgkCbSignalEvent is:
- <= DISPATCH_LEVEL when signaling events of a process in a virtual machine.
- < DISPATCH_LEVEL when signaling events of a local process.
DXGKCB_XXX functions are implemented by Dxgkrnl. To use this callback function, set the members of DXGKARGCB_SIGNALEVENT and then call DxgkCbSignalEvent via the DXGKRNL_INTERFACE.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 10, version 1809 (WDDM 2.5) |
| Header | d3dkmddi.h (include d3dkmddi.h) |
| IRQL | See Remarks |