IMDSPDirectTransfer：：TransferToDevice 方法 (mswmdm.h)

项目
02/29/2024

Windows Media 设备管理器调用 TransferToDevice 方法，以将内容传输内容委托给服务提供商。可以将源指定为文件或操作接口。

语法

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

参数

[in] pwszSourceFilePath

源文件名称。如果指定了WMDM_CONTENT_OPERATIONINTERFACE，则应忽略此参数中包含的值。

[in] pSourceOperation

用作源的操作接口指针。除非指定了WMDM_CONTENT_OPERATIONINTERFACE，否则应忽略此参数中包含的值。

[in] fuFlags

影响此方法行为的标志。 fuFlags 参数必须是以下值之一。

值	说明
WMDM_CONTENT_FILE	源是文件。
WMDM_CONTENT_FOLDER	源是一个文件夹。
WMDM_FILE_CREATE_OVERWRITE	覆盖目标文件（如果已存在）。

[in] pwszDestinationName

应使用此名称将内容传输到设备。此参数是必需的。

[in] pSourceMetaData

元数据接口指针。元数据对象包含源属性。此参数是可选的。

[in] pTransferProgress

进度回调接口。服务提供商应在传输过程中更新信息。此参数是可选的。

[out] ppNewObject

新建的存储对象。此参数是可选的。如果调用方不需要返回新对象，则可以为 NULL 。

返回值

该方法返回 HRESULT。可能的值包括（但并不限于）下表中的项。

返回代码	说明
S_OK	方法成功。
E_INVALIDARG	下列情况之一存在：同时指定 pwszSourceFileName 和 pSourceOperation ; 未指定 pwszDestinationName; fuFlags 无效。
HRESULT_FROM_WIN32 (ERROR_DISK_FULL)	磁盘上没有足够的空间。
HRESULT_FROM_WIN32 (ERROR_FILE_EXISTS)	文件已存在，但未指定WMDM_FILE_CREATE_OVERWRITE。如果设备允许重复的文件名，则可以接受此错误，并且不需要返回此错误。
HRESULT_FROM_WIN32 (ERROR_NOT_SUPPORTED)	设备上不支持传输指定内容。