Funzione DrvEnableDirectDraw (winddi.h)

Articolo
08/27/2023

La funzione DrvEnableDirectDraw abilita l'hardware per l'uso di DirectDraw.

Sintassi

BOOL DrvEnableDirectDraw(
  DHPDEV              dhpdev,
  DD_CALLBACKS        *pCallBacks,
  DD_SURFACECALLBACKS *pSurfaceCallBacks,
  DD_PALETTECALLBACKS *pPaletteCallBacks
);

Parametri

dhpdev

Handle al PDEV restituito dalla routine DrvEnablePDEV del driver.

pCallBacks

Punta alla struttura DD_CALLBACKS da inizializzare dal driver.

pSurfaceCallBacks

Punta alla struttura DD_SURFACECALLBACKS da inizializzare dal driver.

pPaletteCallBacks

Punta alla struttura DD_PALETTECALLBACKS da inizializzare dal driver.

Valore restituito

DrvEnableDirectDraw restituisce TRUE se ha esito positivo; in caso contrario, restituisce FALSE.

Commenti

GDI chiama la funzione DrvEnableDirectDraw del driver per ottenere puntatori ai callback DirectDraw supportati dal driver. Il driver deve impostare i membri del puntatore a funzione di DD_CALLBACKS, DD_SURFACECALLBACKS e DD_PALETTECALLBACKS in modo da puntare a tali funzioni implementate. Un driver deve anche impostare i campi di bit corrispondenti nei membri dwFlags di queste strutture per tutti i callback supportati.

L'implementazione drvEnableDirectDraw di un driver può anche dedicare risorse hardware come la memoria di visualizzazione per l'uso solo da DirectDraw.