IltmmMemory::SetData
#include "ltmm.h"
|
C Syntax |
HRESULT IltmmMemory_SetData(pMem, Index, Count, Data) |
|
C++ Syntax |
HRESULT SetData(Index, Count, Data) |
|
IltmmMemory *pMem; |
/* pointer to an interface */ |
|
long Index; |
/* offset */ |
|
long Count; |
/* size */ |
|
VARIANT Data; |
/* data to set */ |
Sets new data in the object’s buffer, at the specified index, with the specified size.
|
Parameter |
Description |
|
pMem |
Pointer to an IltmmMemory interface. |
|
Index |
Index (offset) at which to set the new data in the object’s buffer. |
|
Count |
Size, in bytes (number of byte elements), of the data to set. |
|
Data |
VARIANT containing a reference to a SAFEARRAY of data. The array should have one dimension and should contain byte elements. |
Returns
|
S_OK |
The function was successful. |
|
<> S_OK |
An error occurred. Refer to the Error Codes or the HRESULT error codes in the DirectShow documentation. |
Comments
If the size of the data to set is larger than the size available after the offset, the function will update only the available space between the offset and the end of the buffer.
The area of the buffer to which the new data is copied will be locked for the duration of the call.
Required DLLs and Libraries
|
LTMM For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application. |
See Also
|
Elements: |
IltmmMemory::get_BufferSize, IltmmMemory::CopyData, IltmmMemory::GetData, IltmmMemory::put_BufferSize, IltmmMemory::GetByte, IltmmMemory::GetData |
|
Topics: |
Example
For a C example, refer to Use ltmmMemory for Memory Conversion for C.
For a C++ example, refer to Use ltmmMemory for Memory Conversion for C++.