IWMDMStorageControl：：Read 方法 (mswmdm.h)

發行項
02/29/2024

Read 方法會將目前的記憶體複製到電腦。

語法

HRESULT Read(
  [in] UINT           fuMode,
  [in] LPWSTR         pwszFile,
  [in] IWMDMProgress  *pProgress,
  [in] IWMDMOperation *pOperation
);

參數

[in] fuMode

用於讀取作業的處理模式。下表列出可在 fuMode 參數中指定的處理模式。您必須只指定前兩種模式的其中一個，而且最後三個模式的其中一個 (WMDM_CONTENT) 模式。如果同時指定WMDM_MODE_BLOCK和WMDM_MODE_THREAD，則會使用區塊模式。

模式	Description
WMDM_MODE_BLOCK	作業是使用區塊模式處理來執行。呼叫在作業完成之前不會傳回。
WMDM_MODE_THREAD	作業是使用線程模式處理來執行。呼叫會立即傳回，且作業會在背景線程中執行。
WMDM_CONTENT_FILE	呼叫端要求 Windows Media 裝置管理員將檔案從可攜式裝置讀取到硬碟上的檔案。呼叫端應該在 pwszFileName 參數中指出檔案的完整路徑和名稱。
WMDM_CONTENT_FOLDER	呼叫端要求 Windows Media 裝置管理員讀取指定資料夾、資料夾的內容，以及從可攜式裝置到硬碟上任何子資料夾的內容。呼叫端應該會指出 pwszFileName 參數中硬碟上目標目錄的完整路徑。任何 Microsoft 提供的服務提供者目前都不支援此功能。
WMDM_CONTENT_OPERATIONINTERFACE	應用程式實作的 IWMDMOperation 介面正用來讀取數據，而不是傳入檔名。

[in] pwszFile

從可攜式裝置複製內容之電腦上的完整檔名指標。檔名應包含擴展名;不會使用裝置上目前記憶體的擴充功能。如果在 fuMode 中指定WMDM_CONTENT_OPERATIONINTERFACE，則會忽略此參數。

[in] pProgress

應用程式已實作的 IWMDMProgress 介面選擇性指標，以追蹤進行中的作業進度。

[in] pOperation

IWMDMOperation 介面的選擇性指標，這是一組選擇性的方法，用來增強媒體裝置的內容傳輸。如果在 fuMode 中指定了 WMDM_CONTENT_FILE 或 WMDM_CONTENT_FOLDER，此參數必須是 NULL。

傳回值

方法會傳回 HRESULT。 Windows Media 裝置管理員中的所有介面方法都可以傳回下列任何一種錯誤碼類別：

標準 COM 錯誤碼
轉換成 HRESULT 值的 Windows 錯誤碼
Windows Media 裝置管理員錯誤碼

如需可能錯誤碼的廣泛清單，請參閱錯誤碼。

備註

此方法會自動覆寫 pwszFilename 所指定的現有檔案。即使成功也一樣

如果指定WMDM_MODE_THREAD旗標，您應該呼叫 IWMDMProgress2：：End2 或 IWMDMProgress3：：End3 來取得完成狀態。這些方法可確保作業已完成，也會傳回具有成功或失敗資訊的 HRESULT。

如果應用程式使用 WMDM_MODE_THREAD 並傳遞非 NullpProgress 參數，則應用程式必須確保 pProgress 所屬的物件在讀取作業完成之前不會終結，因為 Windows Media 裝置管理員會將進度通知傳送給這個物件。只有在收到 End 通知之後，才能終結此物件。若無法這麼做，將會導致存取違規。