IWMDMOperation::TransferObjectData

The TransferObjectData method transfers a block of data.

Syntax

HRESULT TransferObjectData(
  BYTE*  pData,
  DWORD*  pdwSize,
  BYTE  abMac[WMDM_MAC_LENGTH]
);

Parameters

pData

[in, out] Pointer to a buffer that either receives or passes the block of data. This parameter must be included in the message authentication code and must be encrypted before the call for data transfer in both directions.

pdwSize

[in, out] Pointer to a double word containing the transfer buffer size. This parameter must be included in both the input and output message authentication codes.

abMac

[in, out] 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
S_FALSE	The data was transferred. There is no more data, and no more has been requested.
WMDM_E_USER_CANCELLED	The application instructs Windows Media Device Manager to cancel the current operation without waiting for it to finish.
E_FAIL	An unspecified error occurred.

Remarks

If either E_FAIL or WMDM_E_USER_CANCELLED is returned from this call, the operation is cancelled and the End method is called. If the application is using block mode and returns WMDM_E_USER_CANCELLED, then Windows Media Device Manager will return this same error to the application.

See Also

IWMDMOperation Interface

Previous

Next