Metodo IDirectDraw7::D uplicateSurface (ddraw.h)
Duplica un oggetto DirectDrawSurface.
Sintassi
HRESULT DuplicateSurface(
[in] LPDIRECTDRAWSURFACE7 unnamedParam1,
[out] LPDIRECTDRAWSURFACE7 *unnamedParam2
);
Parametri
[in] unnamedParam1
Indirizzo dell'interfaccia IDirectDrawSurface7 per la superficie da duplicare.
[out] unnamedParam2
Indirizzo di una variabile che contiene un puntatore all'interfaccia IDirectDrawSurface7 per l'oggetto DirectDrawSurface appena duplicato.
Valore restituito
Se il metodo ha esito positivo, il valore restituito viene DD_OK.
Se ha esito negativo, il metodo può restituire uno dei valori di errore seguenti:
- DDERR_CANTDUPLICATE
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_OUTOFMEMORY
- DDERR_SURFACELOST
Commenti
DuplicateSurface crea un nuovo oggetto DirectDrawSurface che punta alla stessa memoria di superficie di un oggetto DirectDrawSurface esistente. Questo duplicato può essere usato esattamente come l'oggetto originale. La memoria della superficie viene rilasciata dopo il rilascio dell'ultimo oggetto a cui fa riferimento. Non è possibile duplicare una superficie primaria, una superficie 3D o una superficie creata in modo implicito.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | ddraw.h |
| Libreria | Ddraw.lib |
| DLL | Ddraw.dll |