capture 命令

擷取命令會複製框架緩衝區的內容，並將其儲存在指定的檔案中。數位視訊裝置可辨識此命令。

若要傳送此命令，請使用lpszCommand參數集呼叫mciSendString函式，如下所示。

_stprintf_s(
  lpszCommand, 
  TEXT("capture %s %s %s"), 
  lpszDeviceID, 
  lpszCapture, 
  lpszFlags
);

參數

lpszDeviceID

MCI 裝置的識別碼。當裝置開啟時，會指派此識別碼或別名。

lpszCapture

下列一或多個旗標：

值	意義
as pathname	指定所擷取映射的目的地路徑和檔案名。這個旗標是必要項目。
在矩形	指定裝置裁剪並儲存到磁片的框架緩衝區內的矩形區域。如果省略，裁剪的區域預設為先前放置此裝置實例的「來源」命令上所指定的或預設矩形。

lpszFlags

可以是「wait」、「notify」、「test」或這些組合。如需這些旗標的詳細資訊，請參閱 Wait、Notify 和 Test Flags。

如果成功或發生錯誤，則傳回零。

如果裝置目前現正播放動作視訊，或執行一些其他需要大量資源的作業，此命令可能會失敗。如果即時更新框架緩衝區，則更新會立即暫停，以便擷取完整的映射。如果裝置暫停更新，可能會有視覺或可聽見的效果。如果未設定檔案格式、壓縮演算法和品質層級，則會使用預設值。

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]