restore コマンド

restore コマンドは、ファイルからフレームバッファーに静止イメージをコピーします。これはキャプチャコマンドの逆です。デジタルビデオデバイスはこのコマンドを認識します。

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

_stprintf_s(
  lpszCommand, 
  TEXT("restore %s %s %s"), 
  lpszDeviceID, 
  lpszRestore, 
  lpszFlags
);

パラメーター

lpszDeviceID

MCI デバイスの識別子。この識別子またはエイリアスは、デバイスを開いたときに割り当てられます。

lpszRestore

次のフラグのうち 1 つ以上。

値	説明
四角形	フレームバッファーの原点を基準とした四角形を指定します。四角形は X1 Y1 X2 Y2 として指定されます。座標 X1 Y1 は左上隅を指定し、座標 X2 Y2 は幅と高さを指定します。このフラグを使用しない場合、イメージはフレームバッファーの左上隅にコピーされます。
ファイル名から	呼び出すイメージファイル名を指定します。このフラグは必須です。

lpszFlags

"wait"、"notify"、"test"、またはこれらの組み合わせを指定できます。これらのフラグの詳細については、「待機、通知、およびテストフラグ」を参照してください。

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

デバイスは、さまざまな画像形式を認識できます。Windows デバイスに依存しないビットマップは常に認識されます。

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]