Platform SDK: DirectX

IDirectDrawSurface7::GetPrivateData

The IDirectDrawSurface7::GetPrivateData method copies the private data associated with the surface to a provided buffer.

HRESULT GetPrivateData(
  REFGUID guidTag,
  LPVOID  lpBuffer,
  LPDWORD lpcbBufferSize
); 

Parameters

guidTag
Reference to (C++) or address of (C) the globally unique identifier that identifies the private data to be retrieved.
lpBuffer
Address of a previously allocated buffer to be filled with the requested private data if the call succeeds. The application calling this method is responsible for allocating and releasing this buffer.
lpcbBufferSize
Size of the buffer at lpBuffer, in bytes. If this value is less than the actual size of the private data (such as 0), the method sets this parameter to the required buffer size, and the method returns DDERR_MOREDATA.

Return Values

If the method succeeds, the return value is DD_OK.

If it fails, the method can return one of the following error values:

DDERR_EXPIRED
DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_MOREDATA
DDERR_NOTFOUND
DDERR_OUTOFMEMORY

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 98.
  Header: Declared in ddraw.h.

See Also

IDirectDrawSurface7::SetPrivateData, IDirectDrawSurface7::FreePrivateData