where 命令

其中 命令會擷取指定來源或目的地區域的矩形。 這個矩形是使用 put 命令來指定。 數位視訊和視訊重迭裝置可辨識此命令。

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

_stprintf_s(
  lpszCommand, 
  TEXT("where %s %s %s"), 
  lpszDeviceID, 
  lpszRequestRect, 
  lpszFlags
); 

參數

lpszDeviceID

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

lpszRequestRect

旗標，識別擷取其維度的矩形。 下表列出可辨識每個類型 所使用的命令和 旗標的裝置類型。

值	意義	意義
digitalvideo	destinationdestination maxframeframe maxsource	source maxvideovideo maxwindowwindow max
overlay	destinationframe	sourcevideo

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

值	意義
目的地	擷取目的地位移和範圍。 對於視訊重迭裝置，目的地矩形會定義顯示視窗工作區的區域，以顯示畫面緩衝區中的影像資料。
destination max	擷取用戶端矩形的目前大小。
框架	擷取框架緩衝區矩形的位移和範圍。 框架緩衝區矩形會定義接收傳入視訊資料之畫面緩衝區的區域。 來自「影片」矩形的影像會縮放至這個區域。
框架 上限	傳回框架緩衝區的大小上限。
source	擷取來源位移和範圍。 對於視訊重迭裝置，來源矩形會定義顯示在目的地視窗中的畫面緩衝區區域。 裝置會使用此矩形來裁剪影像，再進行延展以配合顯示器上的目的地矩形。
source max	擷取框架緩衝區的大小上限。
影片	擷取視訊矩形的位移和範圍。 視訊矩形會定義傳送至畫面緩衝區之傳入視訊資料的區域。
視訊 最大值	傳回輸入的大小上限。
時間範圍	擷取顯示視窗框架的目前大小和位置。
視窗 最大值	擷取整個顯示器的大小。

lpszFlags

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

傳回值

傳回mciSendString函式之lpszReturnString參數中的矩形。 矩形描述此命令之 lpszRequestRect 參數中指定的區域。 矩形會指定為X1 Y1 X2 Y2。 座標 X1 Y1 會指定矩形的左上角，而座標 X2 Y2 則指定寬度和高度。

範例

下列命令會傳回「電影」裝置的顯示矩形。

where movie destination

規格需求

另請參閱

Mci

MCI 命令字串

把