freeze 命令

凍結命令會凍結 VCR 上的視訊輸入或視訊輸出，或停用對畫面緩衝區的視訊擷取。數位視訊、視訊重迭和 VCR 裝置可辨識此命令。

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

_stprintf_s(
  lpszCommand, 
  TEXT("freeze %s %s %s"), 
  lpszDeviceID, 
  lpszFreezeFlags, 
  lpszFlags
);

參數

lpszDeviceID

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

lpszFreezeFlags

識別要凍結之專案的旗標。下表列出可辨識凍結命令的裝置類型，以及每種類型所使用的旗標。

下表列出可以在 lpszFreezeFlags 參數及其意義中指定的旗標。

值	意義
在矩形	指定將凍結的區域。對於視訊重迭裝置，此區域將會停用視訊擷取。若為數字視訊裝置，除非) 指定「外部」旗標，否則矩形內的圖元將會在其鎖定遮罩位開啟 (。矩形相對於視訊緩衝區原點，並指定為X1 Y1 X2 Y2。座標 X1 Y1 會指定矩形的左上角，而座標 X2 Y2 則指定寬度和高度。
field	凍結第一個欄位。如果) 未指定框架或欄位，則預設會假設欄位 (。
框架	凍結整個框架，並顯示這兩個欄位。
input	凍結輸入影像的目前畫面格，無論是暫停或正在執行。
output	凍結 VCR 輸出的目前畫面格。如果發出凍結時現正播放 VCR，則會凍結目前的畫面，並暫停 VCR。如果發出此命令時暫停 VCR，則會凍結目前的畫面。凍結的映射會保留在輸出裝置上，直到發出 unfreeze 命令為止。如果未指定「輸入」或「輸出」，則會假設「輸出」。
外面	表示使用「at」旗標所指定區域以外的區域已凍結。

lpszFlags

可以是「wait」、「notify」或兩者。對於數位視訊和 VCR 裝置，也可以指定「測試」。如需這些旗標的詳細資訊，請參閱 Wait、Notify 和 Test Flags。

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

搭配 VCR 裝置使用時，此命令適用于畫面擷取卡片。

若要使用「at」旗標指定不規則的取得區域，請使用一系列的凍結和取消凍結命令。有些視訊重迭裝置會限制取得區域的複雜性。

只有在具有「可以凍結」旗標的功能命令呼叫傳回 TRUE時，才支援此命令。

下列命令會在影片緩衝區左上角的 100 圖元方塊中停用視訊擷取。

freeze vboard at 0 0 100 100

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