MCI_CAPTURE コマンド

MCI_CAPTURE コマンドは、フレームバッファーの内容をキャプチャし、指定したファイルに格納します。デジタルビデオデバイスはこのコマンドを認識します。

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_CAPTURE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_DGV_CAPTURE_PARMS) lpCapture
);

パラメーター

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

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

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

MCI_DGV_CAPTURE_AS: lpCapture によって識別される構造体の lpstrFileName メンバーには、宛先パスとファイル名を指定するバッファーのアドレスが含まれています。 (このフラグは必須です)。
MCI_DGV_CAPTURE_AT: lpCapture によって識別される構造体の rc メンバーには、有効な四角形が含まれています。四角形は、トリミングされてディスクに保存されるフレームバッファー内の四角形領域を指定します。省略すると、トリミングされた領域の既定値は、デバイスドライバーのこのインスタンスのソース領域を指定する前のMCI_PUT コマンドで指定または既定の四角形になります。

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