MCI_RESTORE コマンド

MCI_RESTORE コマンドは、ファイルからフレームバッファーにビットマップをコピーします。デジタルビデオデバイスはこのコマンドを認識します。このコマンドは、 MCI_CAPTURE コマンドの反対のアクションを実行します。

このコマンドを送信するには、次のパラメーターを指定して mciSendCommand 関数を呼び出します。

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_RESTORE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_DGV_RESTORE_PARMS) lpRestore
);

パラメーター

wDeviceID: コマンドメッセージを受信する MCI デバイスのデバイス識別子。
dwFlags: MCI_NOTIFY、MCI_WAIT、またはMCI_TEST。これらのフラグの詳細については、「待機、通知、およびテストフラグ」を参照してください。
lpRestore: MCI_DGV_RESTORE_PARMS構造体へのポインター。

成功した場合は 0 を返し、それ以外の場合はエラーを返します。

実装ではさまざまなイメージ形式を認識できますが、Windows デバイスに依存しないビットマップ (DIB) は常に受け入れられます。

デジタルビデオデバイスには、次の追加フラグが適用されます。

MCI_DGV_RESTORE_FROM: lpRestore によって識別される構造体の lpstrFileName メンバーには、ソースファイル名を含むバッファーのアドレスが含まれています。ファイル名は必須です。
MCI_DGV_RESTORE_AT: lpRestore によって識別される構造体の rc メンバーには、有効な四角形が含まれています。四角形は、フレームバッファーの原点を基準とした領域を指定します。座標の最初のペアは、四角形の左上隅を指定します。2 番目のペアは、幅と高さを指定します。このフラグを指定しない場合、イメージはフレームバッファーの左上隅にコピーされます。

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
ヘッダー	Mmsystem.h (Windows.h を含む)