|
|
| Previous | Next |
The TransferContainerData method transfers container file data to the SCP. The SCP breaks down the container internally and reports which parts of the content are available as they are extracted from the container.
Syntax
HRESULT TransferContainerData(
BYTE* pData,
DWORD dwSize,
UINT* pfuReadyFlags,
BYTE abMac[WMDM_MAC_LENGTH]
);
Parameters
pData
[in] Pointer to a buffer holding data from the container file. This parameter must be included in the input message authentication code and must be encrypted.
dwSize
[in] Double word that contains the number of bytes in the buffer. This parameter must be included in the input message authentication code.
pfuReadyFlags
[out] Flag indicating which parts of the container file are ready to be read. This parameter is included in the output message authentication code. The following flag indicates what is ready.
| Flag | Description |
| WMDM_SCP_TRANSFER_OBJECTDATA | Data of the object is available by calling the ObjectData method. |
[in, out] abMac
Array of eight bytes containing the message authentication code for the parameter data of this method. (WMDM_MAC_LENGTH is defined as 8.)
Return Values
If the method succeeds, it returns S_OK. If it fails, it returns an HRESULT error code.
| Return code | Description |
| WMDM_E_NOT_CERTIFIED | The caller is not authorized to use this interface. |
| WMDM_E_NORIGHTS | The caller does not have the rights required to perform the requested operation. |
| WMDM_E_MAC_CHECK_FAILED | The message authentication code is not valid. |
| S_FALSE | The method failed. Terminate interaction with SCP. |
| E_INVALIDARG | A parameter is invalid or is a NULL pointer. |
| E_FAIL | An unspecified error occurred. |
Remarks
Windows Media Device Manager calls this method repeatedly, transferring data from the container file to the SCP. As the SCP collects the data and extracts the various objects from it, it reports back to Windows Media Device Manager which objects, if any, are available after each call. If no objects are available, the SCP returns S_OK with the pfuReadyFlags parameter set to zero.
See Also
| Previous | Next |