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 [僅限傳統型應用程式] |
| 標頭 |
|