IDirect3DResource8::GetPrivateData

This method copies the private data associated with the resource to a provided buffer.

HRESULT GetPrivateData(
  REFGUID refguid,
  void* pData,
  DWORD* pSizeOfData
);

Parameters

• refguid
  [in] Reference to (C++) or address of (C) the globally unique identifier that identifies the private data to retrieve.
• pData
  [out] Pointer to a previously allocated buffer to fill with the requested private data if the call succeeds. The application calling this method is responsible for allocating and releasing this buffer.
• pSizeOfData
  [in, out] Pointer to the size of the buffer at pData, 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 D3DERR_MOREDATA.

Return Values

If the method succeeds, the return value is D3D_OK.

If the method fails, the return value can be one of the following values:

• D3DERR_INVALIDCALL
• D3DERR_MOREDATA
• D3DERR_NOTFOUND

Remarks

This method applies to the following interfaces, which inherit from IDirect3DResource8.

• IDirect3DBaseTexture8
• IDirect3DIndexBuffer8
• IDirect3DTexture8
• IDirect3DVertexBuffer8

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: D3d8.h.
Link Library: D3d8.lib.

See Also

IDirect3DResource8::FreePrivateData | IDirect3DResource8::SetPrivateData | IDirect3DResource8

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.