put 命令

put 命令會定義用於顯示的來源影像和目的地視窗區域。 數位視訊和視訊重迭裝置可辨識此命令。

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

_stprintf_s(
  lpszCommand, 
  TEXT("put %s %s %s"), 
  lpszDeviceID, 
  lpszRegions, 
  lpszFlags
); 

參數

lpszDeviceID

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

lpszRegions

用於定義區域的旗標。 下表列出可辨識 put 命令的裝置類型，以及每種類型所使用的旗標。

值	意義	意義
digitalvideo	矩形來源矩形來源矩形框架的目的地目的地	矩形視窗用戶端視窗用戶端視窗用戶端在矩形的矩形視窗視窗的視訊影片
overlay	矩形框架框架的目的地目的地	矩形視訊影片的來源來源矩形

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

值	意義
目的地	選取目的地視窗的整個工作區以顯示資料。
矩形的目的地	選取用來顯示影像之目的地視窗的工作區部分。 當指定顯示視窗的區域且裝置支援延展時，來源影像會延展到目的地位移和範圍。
框架	選取整個畫面緩衝區以接收傳入的視訊影像。
矩形的框架	選取畫面緩衝區的一部分，以接收傳入的視訊影像。
source	選取要顯示在目的地視窗中的整個影像。
矩形的來源	選取要顯示在目的地視窗中的影像部分。 指定來源影像的區域，且裝置支援延展時，來源影像會延展到目的地位移和範圍。
影片	選取要擷取在畫面緩衝區中的整個傳入視訊影像。
矩形的視訊	選取要擷取在畫面緩衝區中之傳入視訊影像的一部分。
時間範圍	還原顯示的初始視窗大小。 此命令也會顯示視窗。
矩形的視窗	變更顯示視窗的大小和位置。 指定的矩形相對於顯示視窗的父視窗， (通常為桌面) 如果 已針對開啟 命令使用「style child」 旗標。 若要變更視窗的位置而不變更其高度或寬度，請為高度和寬度指定零。
視窗用戶端	還原視窗的工作區。
矩形的視窗用戶端	變更視窗工作區的大小和位置。 指定的矩形相對於用戶端視窗的父視窗。 若要變更視窗的位置而不變更其高度或寬度，請為高度和寬度指定零。

當旗標包含矩形時，矩形座標會相對於視窗原點或影像原點，適當地指定為X1 Y1 X2 Y2。 座標 X1Y1 會指定左上角，而 座標 X2Y2 則指定矩形的寬度和高度。

lpszFlags

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

傳回值

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

備註

put 命令會在使用視訊重迭裝置時定義下列一或多個矩形：

• 影片矩形會定義要擷取之傳入視訊影像的區域。
• 框架矩形會定義接收傳入視訊影像之畫面緩衝區的區域。
• 來源矩形會定義框架緩衝區的哪個區域會複製到目的地矩形。
• 目的地矩形會定義接收視訊影像之顯示視窗工作區的區域。

視訊矩形與框架矩形的關聯方式與來源矩形與目的矩形相同。 延展可能會從視訊矩形到框架矩形，以及從來源矩形到目的矩形。 並非所有裝置都支援延展，而且必須使用 set 命令) 來啟用 (。

下列命令會定義影片、畫面和來源的三個區域。

put vboard video 120 120 200 200 frame 0 0 200 200 source 0 0 200 200

此範例中的區域定義如下：

• 從左上角的原點 120 圖元開始，傳入視訊資料的 200 圖元區域將會擷取到畫面緩衝區。
• 視訊資料會放在畫面緩衝區左上角的 200 圖元 200 圖元區域。
• 傳輸是從框架緩衝區左上角的 200 圖元區域到目的地視窗的 200 圖元區域進行。

規格需求

另請參閱

Mci

MCI 命令字串

open

set