MCI_PUT命令

  • 發行項

MCI_PUT命令會設定來源、目的地和框架矩形。 數位視訊和視訊重迭裝置可辨識此命令。

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_PUT, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpDest
);

參數

wDeviceID

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

dwFlags

MCI_NOTIFY、MCI_WAIT或數位視訊裝置MCI_TEST。 如需這些旗標的相關資訊，請參閱 Wait、Notify 和 Test Flags。

lpDest

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

傳回值

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

備註

下列其他旗標會搭配 digitalvideo 裝置類型使用：

MCI_DGV_PUT_CLIENT

為 MCI_DGV_RECT定義的矩形會套用至用戶端視窗的位置。 指定的矩形相對於顯示視窗的父視窗。 MCI_DGV_PUT_WINDOW必須與這個旗標同時設定。

MCI_DGV_PUT_DESTINATION

為 MCI_DGV_RECT定義的矩形會指定目的地矩形。 目的地矩形會指定與此設備磁碟機實例相關聯的用戶端視窗部分，以顯示影像或視訊。

MCI_DGV_PUT_FRAME

針對 MCI_DGV_RECT 定義的矩形會套用至框架矩形。 框架矩形會指定框架緩衝區的部分，這些緩衝區會用來作為從視訊矩形取得之視訊影像的目的地。 視訊應調整為符合框架緩衝區矩形。

矩形是在框架緩衝區座標中指定。 預設矩形是完整框架緩衝區。 指定此矩形可讓裝置在影像將資料數位化時調整影像。 無法調整映射的裝置會使用MCIERR_UNSUPPORTED_FUNCTION來拒絕此命令。 您可以使用 MCI_GETDEVCAPS_CAN_STRETCH 旗標搭配 MCI_GETDEVCAPS 命令來判斷裝置是否調整映射。 如果裝置無法調整映射，則會傳回 FALSE 。

MCI_DGV_PUT_SOURCE

為 MCI_DGV_RECT定義的矩形會指定來源矩形。 來源矩形會指定要調整框架緩衝區的哪個部分，以符合目的地矩形。

MCI_DGV_PUT_VIDEO

針對 MCI_DGV_RECT 定義的矩形會套用至視訊矩形。 視訊矩形會指定目前簡報來源的哪個部分會儲存在畫面緩衝區中。 矩形是使用簡報來源的自然座標來指定。 它允許在畫面緩衝區中儲存影像和視訊之前所發生的裁剪規格。 預設矩形是完整作用中的掃描區域或完整解壓縮的影像和視訊。

MCI_DGV_PUT_WINDOW

針對 MCI_DGV_RECT 定義的矩形會套用至顯示視窗。 這個矩形相對於顯示視窗的父視窗， (通常是桌面) 。 如果未指定視窗，則會預設為初始視窗大小和位置。

MCI_DGV_RECT

lpDest所識別結構的rc成員包含有效的矩形。

若為數字視訊裝置， lpDest 會指向 MCI_DGV_PUT_PARMS 結構。

下列其他旗標會與 重迭 裝置類型搭配使用：

MCI_OVLY_PUT_DESTINATION

為 MCI_OVLY_RECT定義的矩形會指定用來顯示影像的用戶端視窗區域。 矩形包含相對於視窗原點之影像的位移和可見範圍。 如果框架正在延展，來源會延展至目的地矩形。

MCI_OVLY_PUT_FRAME

針對 MCI_OVLY_RECT 定義的矩形會指定用來接收視訊影像的視訊緩衝區區域。 矩形包含相對於視訊緩衝區原點的緩衝區區域位移和範圍。

MCI_OVLY_PUT_SOURCE

為 MCI_OVLY_RECT定義的矩形會指定用來作為數位影像來源的視訊緩衝區區域。 矩形包含視訊緩衝區相對於其原點的裁剪矩形的位移和範圍。

MCI_OVLY_PUT_VIDEO

為 MCI_OVLY_RECT定義的矩形會指定視訊緩衝區所擷取的視訊來源區域。 矩形包含視訊來源相對於其原點的裁剪矩形的位移和範圍。

MCI_OVLY_RECT

lpDest所識別結構的rc成員包含有效的顯示矩形。 如果未指定此旗標，預設矩形會符合要裁剪之視訊緩衝區或視窗的座標。

若為視訊重迭裝置， lpDest 會指向 MCI_OVLY_RECT_PARMS 結構。

規格需求

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

另請參閱

Mci

MCI 命令