PFND3DDDI_CREATEOVERLAY funzione di callback (d3dumddi.h)

La funzione CreateOverlay alloca l'hardware di sovrapposizione e rende visibile la sovrapposizione.

Sintassi

PFND3DDDI_CREATEOVERLAY Pfnd3dddiCreateoverlay;

HRESULT Pfnd3dddiCreateoverlay(
  HANDLE hDevice,
  D3DDDIARG_CREATEOVERLAY *unnamedParam2
)
{...}

hDevice

Handle per il dispositivo di visualizzazione (contesto grafico).

unnamedParam2

pData [in, out]

Puntatore a una struttura D3DDDIARG_CREATEOVERLAY che descrive la sovrapposizione.

CreateOverlay restituisce uno dei valori seguenti:

Codice restituito	Descrizione
S_OK	La sovrapposizione viene creata correttamente.
E_OUTOFMEMORY	CreateOverlay non è stato possibile completare a causa di memoria insufficiente.
D3DDDIERR_NOTAVAILABLE	CreateOverlay non è stato possibile completare perché la larghezza di banda insufficiente era disponibile o l'hardware di sovrimpressione richiesto non era disponibile.
D3DDDIERR_UNSUPPORTEDOVERLAYFORMAT	Il formato di sovrapposizione specificato non è supportato dall'hardware di sovrapposizione.
D3DDDIERR_UNSUPPORTEDOVERLAY	L'hardware di sovrapposizione non è supportato per le dimensioni e la modalità di visualizzazione specificate.

Le sovrapposizioni sono indipendenti dalle risorse visualizzate usando le sovrimpressione.

Requisito	Valore
Client minimo supportato	Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione	Desktop
Intestazione	d3dumddi.h (include D3dumddi.h)