IWMDMStorageControl::Read メソッド (mswmdm.h)

[アーティクル]
03/05/2024

Read メソッドは、現在のストレージをコンピューターにコピーします。

構文

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

パラメーター

[in] fuMode

読み取り操作に使用される処理モード。次の表に、 fuMode パラメーターで指定できる処理モードを示します。最初の 2 つのモードのうちの 1 つ、および最後の 3 つの (WMDM_CONTENT) モードのうちの 1 つだけを指定する必要があります。 WMDM_MODE_BLOCKとWMDM_MODE_THREADの両方が指定されている場合は、ブロックモードが使用されます。

モード	説明
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 を使用し、null 以外の pProgress パラメーターを渡す場合、Windows Media デバイスマネージャーはこのオブジェクトに進行状況通知を送信するため、読み取り操作が完了するまで pProgress が属するオブジェクトが破棄されないようにする必要があります。このオブジェクトは、End 通知を受信した後にのみ破棄できます。これを行わないと、アクセス違反が発生します。