Metodo IDirectDrawSurface7::SetPrivateData (ddraw.h)

Associa i dati alla superficie destinata all'uso dell'applicazione, non da DirectDraw. I dati vengono passati per valore e a una singola superficie possono essere associati più set di dati.

Sintassi

HRESULT SetPrivateData(
  [in] REFGUID unnamedParam1,
  [in] LPVOID  unnamedParam2,
  [in] DWORD   unnamedParam3,
  [in] DWORD   unnamedParam4
);

Parametri

[in] unnamedParam1

Riferimento a (C++) o indirizzo di (C) l'identificatore univoco globale che identifica i dati privati da impostare.

[in] unnamedParam2

Puntatore a un buffer che contiene i dati da associare alla superficie.

[in] unnamedParam3

Valore di dimensione del buffer in byte lpData.

[in] unnamedParam4

Valore che può essere impostato su uno dei flag seguenti. Questi flag descrivono il tipo di dati che vengono passati o richiedono che i dati vengano invalidati quando la superficie cambia.

(nessuna)

Se non vengono specificati flag, DirectDraw alloca la memoria per contenere i dati all'interno del buffer e copia i dati nel nuovo buffer. Il buffer allocato da DirectDraw viene liberato automaticamente, a seconda delle esigenze.

DDSPD_IUNKNOWNPOINTER

I dati in lpData sono un puntatore a un'interfaccia IUnknown . DirectDraw chiama automaticamente il metodo IUnknown::AddRef di questa interfaccia. Quando questi dati non sono più necessari, DirectDraw chiama automaticamente il metodo IUnknown::Release di questa interfaccia.

DDSPD_VOLATILE

Il buffer in lpData è valido solo mentre la superficie rimane invariata. Se il contenuto della superficie cambia, le chiamate successive al metodo IDirectDrawSurface7::GetPrivateData restituiscono DDERR_EXPIRED.

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_INVALIDOBJECT
• DDERR_INVALIDPARAMS
• DDERR_OUTOFMEMORY

Commenti

DirectDraw non gestisce la memoria in lpData. Se questo buffer è stato allocato dinamicamente, il chiamante deve liberare la memoria.

Requisiti

Vedi anche

IDirectDrawSurface7