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

  • Artículo

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 (como 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 realiza 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

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado ddraw.h
Library Ddraw.lib
Archivo DLL Ddraw.dll

Consulte también

IDirectDrawSurface7