Share via

IWMDMOperation::TransferObjectData

  • Article
banner art

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 DWORD containing the transfer buffer size. This parameter must be included in both the input and output message authentication codes.

abMac[WMDM_MAC_LENGTH]

[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

The method returns an HRESULT. All the interface methods in Windows Media Device Manager and service provider can return any of the following classes of error codes:

  • Standard COM error codes
  • Windows error codes converted to HRESULT values
  • Windows Media Device Manager error codes

For a complete list of possible error codes, see Error Codes.

Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK The method succeeded.
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.
WMDM_E_MAC_CHECK_FAILED Message authentication check failed.

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.

Requirements

Header: Defined in wmdm.idl.

Library: mssachlp.lib

See Also