Funzione NtGdiDdFlip

  • Articolo

[Questa funzione è soggetta a modifiche con ogni revisione del sistema operativo. Usare invece Microsoft DirectDraw e Microsoft Direct3DAPIs; queste API isolano le applicazioni da tali modifiche al sistema operativo e nascondono molte altre difficoltà coinvolte nell'interagire direttamente con i driver di visualizzazione.

Causa l'interscambio della memoria di superficie associata alla destinazione e alle superfici correnti.

Sintassi

DWORD APIENTRY NtGdiDdFlip(
  _In_    HANDLE       hSurfaceCurrent,
  _In_    HANDLE       hSurfaceTarget,
  _In_    HANDLE       hSurfaceCurrentLeft,
  _In_    HANDLE       hSurfaceTargetLeft,
  _Inout_ PDD_FLIPDATA puFlipData
);

Parametri

hSurfaceCurrent [in]

Handle alla struttura DD_SURFACE_LOCAL che descrive la superficie corrente.

hSurfaceTarget [in]

Gestire la struttura DD_SURFACE_LOCAL che descrive la superficie di destinazione; ovvero la superficie a cui il driver deve scorrere.

hSurfaceCurrentLeft [in]

Gestire la struttura DD_SURFACE_LOCAL che descrive la superficie sinistra corrente.

hSurfaceTargetLeft [in]

Gestire la struttura DD_SURFACE_LOCAL che descrive la superficie di destinazione sinistra a cui passare.

puFlipData [in, out]

Puntatore a una struttura DD_FLIPDATA che contiene le informazioni necessarie per eseguire il capovolgimento.

Valore restituito

NtGdiDdFlip restituisce uno dei codici di callback seguenti.

Codice restituito Descrizione
DDHAL_DRIVER_HANDLED
 Il driver ha eseguito l'operazione e ha restituito un codice restituito valido per tale operazione. Se questo codice è DD_OK, DirectDraw o Direct3D procede con la funzione. In caso contrario, DirectDraw o Direct3D restituisce il codice di errore fornito dal driver e interrompe la funzione.
DDHAL_DRIVER_NOTHANDLED
 Il driver non ha alcun commento sull'operazione richiesta. Se è necessario che il driver abbia implementato un callback specifico, DirectDraw o Direct3D segnala una condizione di errore. In caso contrario, DirectDraw o Direct3D gestisce l'operazione come se il callback del driver non fosse stato definito eseguendo l'implementazione indipendente dal dispositivo DirectDraw o Direct3D.

 

Requisiti

Requisito Valore
Client minimo supportato
 Windows 2000 Professional [solo app desktop]
Server minimo supportato
 Windows 2000 Server [solo app desktop]
Intestazione
Ntgdi.h

Vedi anche

Supporto client a basso livello di grafica