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

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

Move メソッドは、現在のストレージをデバイス上の新しい場所に移動します。

構文

HRESULT Move(
  [in] UINT          fuMode,
  [in] IWMDMStorage  *pTargetObject,
  [in] IWMDMProgress *pProgress
);

パラメーター

[in] fuMode

移動操作を呼び出す処理モードと、実行する移動の種類。次の 2 つのモードのいずれかを正確に指定します。両方のモードが指定されている場合は、ブロックモードが使用されます。

モード	説明
WMDM_MODE_BLOCK	この操作は、ブロックモード処理を使用して実行されます。操作が完了するまで、呼び出しは戻りません。
WMDM_MODE_THREAD	操作はスレッドモード処理を使用して実行されます。呼び出しはすぐに返され、操作はバックグラウンドスレッドで実行されます。

次の表に、オブジェクトの移動先を示すフラグの一覧を示します。このテーブルの 1 つの値は、ビットごとの OR を使用して、前の Mode テーブルの 1 つの値と組み合わされます。

フラグ	説明
WMDM_STORAGECONTROL_INSERTBEFORE	オブジェクトは、ターゲットオブジェクトの前に挿入されます。
WMDM_STORAGECONTROL_INSERTINTO	オブジェクトがターゲットオブジェクトに挿入されます。
WMDM_STORAGECONTROL_INSERTAFTER	オブジェクトは、ターゲットオブジェクトの後に挿入されます。

[in] pTargetObject

現在のオブジェクトを配置する前または後のオブジェクトへのポインター。

[in] pProgress

実行中の操作の進行状況を追跡するためにアプリケーションによって実装された IWMDMProgress インターフェイスへのオプションのポインター。

戻り値

このメソッドは HRESULT を返します。 Windows Media デバイスマネージャーのすべてのインターフェイスメソッドは、次のいずれかのエラーコードクラスを返すことができます。

標準 COM エラーコード
HRESULT 値に変換された Windows エラーコード
Windows Media デバイスマネージャーエラーコード

考えられるエラーコードの詳細な一覧については、「エラーコード」を参照してください。

注釈

ファイルまたはディレクトリは、同じルートストレージ内でのみ移動できます。

WMDM_MODE_THREAD フラグが指定されている場合は、IWMDMProgress2::End2 または IWMDMProgress3::End3 を呼び出して完了状態を取得する必要があります。これらのメソッドを使用すると、操作が完了し、成功または失敗の情報を含む HRESULT も返されます。

アプリケーションで WMDM_MODE_THREADを使用し、null 以外の pProgress パラメーターを渡す場合、Windows Media デバイスマネージャーはこのオブジェクトに進行状況通知を送信するため、pProgress が属するオブジェクトが移動操作が完了するまで破棄されないようにする必要があります。このオブジェクトは、End 通知を受信した後にのみ破棄できます。これを行わないと、アクセス違反が発生します。