Metodo IDirectDrawSurface7::GetPrivateData (ddraw.h)

Copia i dati privati associati a questa superficie in un buffer fornito.

Sintassi

HRESULT GetPrivateData(
  [in]      REFGUID unnamedParam1,
  [out]     LPVOID  unnamedParam2,
  [in, out] LPDWORD unnamedParam3
);

Parametri

[in] unnamedParam1

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

[out] unnamedParam2

Puntatore a un buffer allocato in precedenza che riceve i dati privati richiesti se la chiamata ha esito positivo. L'applicazione che chiama questo metodo deve allocare e rilasciare questo buffer.

[in, out] unnamedParam3

Puntatore a una variabile contenente il valore di dimensione del buffer in lpBuffer, in byte. Se questo valore è minore della dimensione effettiva dei dati privati (ad esempio 0), GetPrivateData imposta la variabile sulla dimensione del buffer richiesta e quindi restituisce DDERR_MOREDATA.

Valore restituito

Se il metodo ha esito positivo, il valore restituito è DD_OK.

Se ha esito negativo, il metodo può restituire uno dei valori di errore seguenti:

• DDERR_EXPIRED
• DDERR_INVALIDOBJECT
• DDERR_INVALIDPARAMS
• DDERR_MOREDATA
• DDERR_NOTFOUND
• DDERR_OUTOFMEMORY

Requisiti

Vedi anche

IDirectDrawSurface7