IDirect3DVolume9::SetPrivateData Method

Associates data with the volume that is intended for use by the application, not by Microsoft?Direct3D?

Syntax

HRESULT SetPrivateData(      

    REFGUID refguid,
    void *pData,
    DWORD SizeOfData,
    DWORD Flags
);

Parameters

refguid
[in] Reference to (C++) or address of (C) the globally unique identifier that identifies the private data to set.
pData
[in] Pointer to a buffer that contains the data to associate with the volume.
SizeOfData
[in] Size of the buffer at pData, in bytes.
Flags
[in] Value that describes the type of data being passed, or indicates to the application that the data should be invalidated when the resource changes.
(none)
If no flags are specified, Direct3D allocates memory to hold the data within the buffer and copies the data into the new buffer. The buffer allocated by Direct3D is automatically freed, as appropriate.
D3DSPD_IUNKNOWN
The data at pData is a pointer to an IUnknown interface. SizeOfData must be set to the size of a pointer to an IUnknown interface, sizeof(IUnknown*). Direct3D automatically calls IUnknown::AddRef through pData and IUnknown::Release when the private data is destroyed. Private data will be destroyed by a subsequent call to IDirect3DVolume9::SetPrivateData with the same globally unique identifier (GUID), a subsequent call to IDirect3DVolume9::FreePrivateData, or when the IDirect3D9 object is released. For more information, see Remarks.

Return Value

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 The method call is invalid. For example, a method's parameter may have an invalid value.
E_OUTOFMEMORY Direct3D could not allocate sufficient memory to complete the call.

Remarks

Direct3D does not manage the memory at pData. If this buffer was dynamically allocated, it is the calling application's responsibility to free the memory.
Data is passed by value, and multiple sets of data can be associated with a single volume.

D3DERR_INVALIDCALL	The method call is invalid. For example, a method's parameter may have an invalid value.
E_OUTOFMEMORY	Direct3D could not allocate sufficient memory to complete the call.