Share via

IWMDMOperation3::TransferObjectDataOnClearChannel (deprecated)

  • Article
banner art

This is preliminary documentation and subject to change.

This topic documents a feature of the Windows Media Device Manager SDK. We recommend that you migrate your application to use the Windows Portable Devices API. For more information, see the Windows Portable Devices SDK.

The TransferObjectDataOnClearChannel method is a more efficient implementation of IWMDMOperation::TransferObjectData.

Syntax

HRESULT TransferObjectDataOnClearChannel(
  BYTE*  pData,
  DWORD*  pdwSize
);

Parameters

pData

[in, out]  Pointer to an unencrypted byte buffer.

pdwSize

[in, out]  Pointer to a DWORD specifying the buffer size.

Return Values

The application should return one of the following HRESULT values.

Return code Description
S_OK The read operation should continue.
WMDM_E_USER_CANCELLED The read operation should be cancelled without finishing.
E_FAIL An unspecified error occurred, and the read operation should be cancelled without finishing.

Remarks

See TransferObjectData to learn about the basics of this function. The difference between this method and TransferObjectData is that this method does not require the sender or receiver to encrypt or decrypt data, which requires extra processing time. Licensed content can still be sent using this method, since the content is always encrypted during transport anyway.

If the application supports this method, it is called in preference to the TransferObjectData.

Requirements

Header: Defined in mswmdm.h.

Library: mssachlp.lib

See Also