Método IDirectDrawSurface7::GetPrivateData (ddraw.h)

2025-05-21

Copia los datos privados asociados a esta superficie en un búfer proporcionado.

Sintaxis

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

Parámetros

[in] unnamedParam1

Referencia a (C++) o dirección de (C) el identificador único global que identifica los datos privados que se van a recuperar.

[out] unnamedParam2

Puntero a un búfer asignado previamente que recibe los datos privados solicitados si la llamada se realiza correctamente. La aplicación que llama a este método debe asignar y liberar este búfer.

[in, out] unnamedParam3

Puntero a una variable que contiene el valor de tamaño del búfer en lpBuffer, en bytes. Si este valor es menor que el tamaño real de los datos privados (por ejemplo, 0), GetPrivateData establece la variable en el tamaño de búfer necesario y, a continuación, devuelve DDERR_MOREDATA.

Valor devuelto

Si el método se ejecuta correctamente, el valor devuelto es DD_OK.

Si se produce un error, el método puede devolver uno de los siguientes valores de error:

DDERR_EXPIRED
DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_MOREDATA
DDERR_NOTFOUND
DDERR_OUTOFMEMORY

Observaciones

Si los datos devueltos son un puntero a un IUnknown o a una de sus clases derivadas, que anteriormente estableció SetPrivateData con una DDSPD_IUNKNOWNPOINTER marca, esa interfaz tendrá su recuento de referencias incrementado antes de que se devuelvan los datos privados.

Requisitos

Requisito	Importancia
de la plataforma de destino de	Windows
encabezado	ddraw.h
Biblioteca	Ddraw.lib
DLL de	Ddraw.dll

Consulte también

IDirectDrawSurface7