IMDSPDirectTransfer：：TransferToDevice 方法 (mswmdm.h)

發行項
03/13/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 參數必須是下列其中一個值。

值	Description
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)	裝置不支援傳輸指定的內容。