LPDD_NOTIFYCALLBACK Rückruffunktion (ddkmapi.h)

Artikel
08/23/2023

Die Rückruffunktion NotifyCallback führt Vorgänge aus, die sich auf ein aufgetretenes Ereignis beziehen.

Syntax

LPDD_NOTIFYCALLBACK LpddNotifycallback;

ULONG LpddNotifycallback(
  DWORD dwFlags,
  PVOID pContext,
  DWORD dwParam1,
  DWORD dwParam2
)
{...}

Parameter

dwFlags

Gibt das Ereignis an, das den Aufruf des Rückrufs verursacht hat. Die Werte in dwParam1 und dwParam2 hängen vom Wert von dwFlags ab. Folgende Werte sind möglich:

Flag	dwParam1	dwParam2
DDNOTIFY_CLOSECAPTURE	hCapture	unused
DDNOTIFY_CLOSEDIRECTDRAW	hDirectDraw	unused
DDNOTIFY_CLOSESURFACE	hSurface	unused
DDNOTIFY_CLOSEVIDEOPORT	hVideoPort	unused
DDNOTIFY_DISPLAY_VSYNC	hDirectDraw	unused
DDNOTIFY_POSTDOSBOX	hDirectDraw	unused
DDNOTIFY_POSTRESCHANGE	hDirectDraw	unused
DDNOTIFY_PREDOSBOX	hDirectDraw	unused
DDNOTIFY_PRERESCHANGE	hDirectDraw	unused
DDNOTIFY_VP_LINE	hVideoPort	unused
DDNOTIFY_VP_VSYNC	hVideoPort	unused

pContext

Enthält einen Wert, den der Aufrufer in einem Aufruf an die DxApi-Funktion übergeben hat, zusammen mit einem bestimmten Funktionsbezeichner. Weitere Informationen zu Funktionsbezeichnern finden Sie unter DxApi.

dwParam1

Handle mit dem Objekt im Zusammenhang mit dem Ereignis, das den Aufruf des Rückrufs verursacht hat.

dwParam2

Nicht verwendet.

Rückgabewert

NotifyCallback gibt null zurück.

Hinweise

Ein Videoaufzeichnungstreiber stellt eine NotifyCallback-Rückruffunktion für die DirectDraw-Runtime bereit, wenn der Videoaufzeichnungstreiber die DxApi-Funktion der Laufzeit aufruft. Weitere Informationen finden Sie unter Benachrichtigen von Rückruffunktionen in einem Videoaufzeichnungstreiber.