MCI_WHERE命令

MCI_WHERE命令會取得視訊裝置的裁剪矩形。 數位視訊和視訊重迭裝置可辨識此命令。 傳回之 RECT的頂端和左成員包含裁剪矩形的原點，而右和下成員則包含裁剪矩形的寬度和高度。 (這不是右下方成員的標準用法。)

若要傳送此命令，請使用下列參數呼叫 mciSendCommand 函式。

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_WHERE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpQuery
);

參數

wDeviceID

要接收命令訊息之 MCI 裝置的裝置識別碼。

dwFlags

MCI_NOTIFY、MCI_WAIT或數位視訊裝置MCI_TEST。 如需這些旗標的相關資訊，請參閱 等候、通知和測試旗標。

lpQuery

MCI_GENERIC_PARMS結構的指標。 (具有擴充命令集的裝置可能會將此結構取代為裝置特定的結構。)

傳回值

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

備註

下列額外的旗標會與 digitalvideo 裝置類型搭配使用：

MCI_DGV_WHERE_DESTINATION

取得矩形區域的描述，用來在目前視窗的工作區中顯示視訊和影像。

MCI_DGV_WHERE_FRAME

取得畫面緩衝區的矩形區域描述，其中會從視訊矩形縮放影像。 矩形座標會放在lpQuery所識別結構的rc成員中。

MCI_DGV_WHERE_MAX

搭配MCI_DGV_WHERE_DESTINATION或MCI_DGV_WHERE_SOURCE使用時，傳回的矩形表示指定區域的寬度和高度上限。 搭配MCI_DGV_WHERE_WINDOW使用時，傳回的矩形會指出整個顯示器的大小。

MCI_DGV_WHERE_SOURCE

取得從框架緩衝區裁剪 (矩形區域的描述，) 延展以符合顯示器上的目的地矩形。

MCI_DGV_WHERE_VIDEO

取得從簡報來源裁剪的矩形區域描述，以填滿框架緩衝區中的框架矩形。 矩形座標會放在lpQuery所識別結構的rc成員中。

MCI_DGV_WHERE_WINDOW

取得顯示視窗框架的描述。

對於數位視訊裝置， lpQuery 參數會指向 MCI_DGV_WHERE_PARMS 結構。 MCI_DGV_WHERE_PARMS結構與MCI_DGV_RECT_PARMS結構相同。

下列額外的旗標會與 重迭 裝置類型搭配使用：

MCI_OVLY_WHERE_DESTINATION

取得目的地顯示矩形。 矩形座標會放在lpQuery所識別結構的rc成員中。

MCI_OVLY_WHERE_FRAME

取得重迭框架矩形。 矩形座標會放在lpQuery所識別結構的rc成員中。

MCI_OVLY_WHERE_SOURCE

取得來源矩形。 矩形座標會放在lpQuery所識別結構的rc成員中。

MCI_OVLY_WHERE_VIDEO

取得視訊矩形。 矩形座標會放在lpQuery所識別結構的rc成員中。

對於視訊重迭裝置， lpQuery 參數會指向 MCI_OVLY_RECT_PARMS 結構。

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
標頭	Mmsystem.h (包含 Windows.h)

另請參閱

Mci

MCI 命令