UID

title

description

helpviewer_keywords

old-location

tech.root

ms.assetid

ms.date

ms.keywords

req.header

req.include-header

req.target-type

req.target-min-winverclnt

req.target-min-winversvr

req.kmdf-ver

req.umdf-ver

req.ddi-compliance

req.unicode-ansi

req.idl

req.max-support

req.namespace

req.assembly

req.type-library

req.lib

req.dll

req.irql

targetos

req.typenames

req.redist

ms.custom

f1_keywords

dev_langs

topic_type

api_type

api_location

api_name

NF:mswmdm.IMDSPDirectTransfer.TransferToDevice

IMDSPDirectTransfer::TransferToDevice (mswmdm.h)

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.

IMDSPDirectTransfer interface [windows Media Device Manager]

TransferToDevice method

IMDSPDirectTransfer.TransferToDevice

IMDSPDirectTransfer::TransferToDevice

IMDSPDirectTransferTransferToDevice

TransferToDevice

TransferToDevice method [windows Media Device Manager]

IMDSPDirectTransfer interface

mswmdm/IMDSPDirectTransfer::TransferToDevice

wmdm.imdspdirecttransfer_transfertodevice

wmdm\imdspdirecttransfer_transfertodevice.htm

WMDM

7a95a23d-751e-4101-a150-3a1e47a14a95

12/05/2018

IMDSPDirectTransfer interface [windows Media Device Manager],TransferToDevice method, IMDSPDirectTransfer.TransferToDevice, IMDSPDirectTransfer::TransferToDevice, IMDSPDirectTransferTransferToDevice, TransferToDevice, TransferToDevice method [windows Media Device Manager], TransferToDevice method [windows Media Device Manager],IMDSPDirectTransfer interface, mswmdm/IMDSPDirectTransfer::TransferToDevice, wmdm.imdspdirecttransfer_transfertodevice

mswmdm.h

Windows

Mssachlp.lib

Windows

19H1

IMDSPDirectTransfer::TransferToDevice

mswmdm/IMDSPDirectTransfer::TransferToDevice

c++

APIRef

kbSyntax

COM

mssachlp.lib

mssachlp.dll

IMDSPDirectTransfer.TransferToDevice

IMDSPDirectTransfer::TransferToDevice

-description

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.

-parameters

-param pwszSourceFilePath [in]

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

-param pSourceOperation [in]

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

-param fuFlags [in]

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.

-param pwszDestinationName [in]

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

-param pSourceMetaData [in]

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

-param pTransferProgress [in]

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

-param ppNewObject [out]

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

-returns

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.