IMDSPDirectTransfer::TransferToDevice method (mswmdm.h)

Article
10/13/2021

The TransferToDevice method is called by Windows Media Device Manager to delegate content transfer content to the service provider. The source can be specified either as a file or as an operation interface.

Syntax

HRESULT TransferToDevice(
  [in]  LPCWSTR        pwszSourceFilePath,
  [in]  IWMDMOperation *pSourceOperation,
  [in]  UINT           fuFlags,
  [in]  LPWSTR         pwszDestinationName,
  [in]  IWMDMMetaData  *pSourceMetaData,
  [in]  IWMDMProgress  *pTransferProgress,
  [out] IMDSPStorage   **ppNewObject
);

Parameters

[in] pwszSourceFilePath

Source file name. The value contained in this parameter should be ignored if WMDM_CONTENT_OPERATIONINTERFACE is specified.

[in] pSourceOperation

Operation interface pointer that serves as the source. The value contained in this parameter should be ignored unless WMDM_CONTENT_OPERATIONINTERFACE is specified.

[in] fuFlags

Flags that affect behavior of this method. The fuFlags parameter must be one of the following values.

Value	Description
WMDM_CONTENT_FILE	The source is a file.
WMDM_CONTENT_FOLDER	The source is a folder.
WMDM_FILE_CREATE_OVERWRITE	Overwrite the destination file if it already exists.

[in] pwszDestinationName

Content should be transferred to the device with this name. This parameter is required.

[in] pSourceMetaData

Metadata interface pointer. The metadata object contains the source properties. This parameter is optional.

[in] pTransferProgress

Progress callback interface. The service provider should update the information during the progress of the transfer. This parameter is optional.

[out] ppNewObject

Newly created storage object. This parameter is optional. This can be NULL if the caller does not need to have the new object returned.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code	Description
S_OK	The method succeeded.
E_INVALIDARG	One of the following is true: Both pwszSourceFileName and pSourceOperation are specified; pwszDestinationName is not specified; fuFlags is invalid.
HRESULT_FROM_WIN32(ERROR_DISK_FULL)	There is not enough space on the disk.
HRESULT_FROM_WIN32(ERROR_FILE_EXISTS)	The file already exists and WMDM_FILE_CREATE_OVERWRITE was not specified. If the device allows duplicate file names, this could be acceptable and this error does not need to be returned.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	Transfer of the specified content is not supported on the device.

Remarks

Windows Media Device Manager queries for IMDSPDirectTransfer interface during every transfer.

If the service provider supports the IMDSPDirectTransfer interface, Windows Media Device Manager simply delegates content transfer to the service provider. In this case, Windows Media Device Manager does not do any processing of the content before sending it to the service provider. The service provider gets full control of the source.

If the service provider does not support the IMDSPDirectTransfer interface, Windows Media Device Manager processes the source files and sends byte packets to the service provider. In addition, for protected content, Windows Media Device Manager calls the secure content provider to process the content before sending it to the service provider.

If IMDSPDirectTransfer is supported, Windows Media Device Manager delegates handling of the content to the service provider. This provides flexibility to the service provider for handling the content. In this case, the service provider is responsible for handling the protected content.

Requirements

Requirement	Value
Target Platform	Windows
Header	mswmdm.h
Library	Mssachlp.lib