LPDD_NOTIFYCALLBACK funzione di callback (ddkmapi.h)
La NotifyCallback funzione di callback esegue operazioni correlate a un evento che si è verificato.
Sintassi
LPDD_NOTIFYCALLBACK LpddNotifycallback;
ULONG LpddNotifycallback(
DWORD dwFlags,
PVOID pContext,
DWORD dwParam1,
DWORD dwParam2
)
{...}
Parametri
dwFlags
Indica l'evento che ha causato la chiamata del callback. I valori in dwParam1 e dwParam2 dipendono dal valore di dwFlags. Sono possibili i valori seguenti:
| Bandiera | dwParam1 | dwParam2 |
|---|---|---|
| DDNOTIFY_CLOSECAPTURE | hCapture | inutilizzato |
| DDNOTIFY_CLOSEDIRECTDRAW | hDirectDraw | inutilizzato |
| DDNOTIFY_CLOSESURFACE | hSurface | inutilizzato |
| DDNOTIFY_CLOSEVIDEOPORT | hVideoPort | inutilizzato |
| DDNOTIFY_DISPLAY_VSYNC | hDirectDraw | inutilizzato |
| DDNOTIFY_POSTDOSBOX | hDirectDraw | inutilizzato |
| DDNOTIFY_POSTRESCHANGE | hDirectDraw | inutilizzato |
| DDNOTIFY_PREDOSBOX | hDirectDraw | inutilizzato |
| DDNOTIFY_PRERESCHANGE | hDirectDraw | inutilizzato |
| DDNOTIFY_VP_LINE | hVideoPort | inutilizzato |
| DDNOTIFY_VP_VSYNC | hVideoPort | inutilizzato |
pContext
Contiene un valore passato dal chiamante in una chiamata alla funzione DxApi insieme a un identificatore di funzione specifico. Per altre informazioni sugli identificatori di funzione, vedere DxApi.
dwParam1
Handle per l'oggetto correlato all'evento che ha causato la chiamata del callback.
dwParam2
Inutilizzato.
Valore restituito
NotifyCallback restituisce zero.
Osservazioni
Un driver di acquisizione video fornisce una NotifyCallback funzione di callback al runtime DirectDraw quando il driver di acquisizione video chiama la funzione DxApi del runtime. Per altre informazioni, vedere Notificare le funzioni di callback in un driver di acquisizione video.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Desktop |
| intestazione |
ddkmapi.h (includere Ddkmapi.h) |