setvideo 命令
setvideo 命令會設定與視訊播放和擷取相關聯的值。 數位視訊和 VCR 裝置可辨識此命令。
若要傳送此命令，請使用lpszCommand參數集呼叫mciSendString函式，如下所示。
_stprintf_s(
lpszCommand,
TEXT("setvideo %s %s %s"),
lpszDeviceID,
lpszVideo,
lpszFlags
);
參數
-
lpszDeviceID
-
MCI 裝置的識別碼。 當裝置開啟時，會指派此識別碼或別名。
-
lpszVideo
-
影片播放和擷取的旗標。 下表列出可辨識 setvideo 命令的裝置類型，以及每個類型所使用的旗標。
值 意義 意義 digitalvideo 演算法 演算法bitsperpel to countbrightness to factorclocktimecolor tofactor contrast to factorgamma to valuehalftoneinputkey color to r：g：bkey index to indexoffonoutput 持續時間調色盤色彩超過索引到newrgb調色盤控制碼，以處理品質描述元記錄畫面播放速率，以將品質描述元記錄畫面播放速率評分至因素來源到來源來源，仍然以品質描述元串流來將音調設為因數 錄影機 offonmonitor輸入數位記錄offrecord 追蹤track_number關閉 record onrecord track track_number onsource，以 輸入 number numbertrack track_number offtrack track_number on 下表列出可以在 lpszVideo 參數及其意義中指定的旗標。
值 意義 演算法 演算法 指定供後續 保留 或 錄製 命令使用的視訊壓縮演算法。 裝置支援的演算法是裝置特定的演算法。 MCI 會定義 演算法的常數 「mpeg」 和 「h261」。如果指定的演算法與目前的檔案格式衝突，則檔案格式會變更為演算法的預設格式。 要計算的 bitsperpel 使用 擷取 或 記錄 命令設定每圖元儲存資料的位數。 亮度到 因素 設定視訊亮度等級。 clocktime 表示「over」 旗標中指定的時間以毫秒為單位。 時間是絕對的，而不是在工作區播放時逐步執行。 色彩到 因素 設定色彩飽和度層級。 與因數對比 設定視訊對比層級。 gamma 對 值 指定 gamma 修正指數乘以 1000。 例如，若要指定 2.2 的指數，請使用 2200 作為 值。 gamma 值為 1.0 (1000) 表示未套用 gamma 修正。 Gamma 校正會調整呈現來源編碼的濃度與顯示亮度之間的對應。 半 色調 導致使用半色調調色盤，而不是預設調色盤。 此旗標只能由 MCIAVI 數位視訊驅動程式辨識。 input 修改 「brightness」、「color」、「contrast」、「gamma」、「sharpness」 或 「tint」 旗標，使其會影響輸入訊號，並修改所錄製的內容。 可能的話，這是監視輸入時的預設值。 r：g：b的索引鍵色彩 設定索引鍵色彩。 r：g：b變數是 RGB 值。 冒號 (：) 分隔個別的紅色、綠色和藍色值。 索引鍵索引 設定索引鍵。 索引變數是實體調色盤索引。 監視以輸入數位 控制要傳遞至 VCR 輸出的來源輸入，而不需變更錄製來源輸入選取範圍。 類型可以是 「output」，或其中一個有效的輸入來源。 如果未指定 「number」，則會選擇該類型的第一個輸入。 offon 啟用或停用視訊的顯示。 停用視訊會將 放置 「目的地」矩形中的圖元設定為純色 (或其預設值，目前視窗的用戶端區域) 為純色。 它不會影響框架緩衝區。無論是工作區或外部輸入的視訊來源，都可能會繼續將新影像儲存在畫面緩衝區中。 在啟用視訊之前，不會顯示它們。 您可以使用 視窗 「狀態」命令來隱藏視窗。 預設值為 setvideo 「on」。 output 修改 「brightness」、「color」、「contrast」、「gamma」、「sharpness」 或 「tint」 旗標，使其只修改顯示的訊號，而不是記錄的內容。 可能的話，這是監視檔案時的預設值。 持續期間 指定使用 因數 變數進行變更所需的時間。 持續時間的單位是目前的時間格式。 變更會隨著工作區的播放而逐步發生。 當播放暫停時，變更也會暫停，直到播放繼續為止。 如果未使用「over」 或不支援，就會立即進行變更。 將索引的調色盤色彩色彩移至newrgb 設定新的調色盤色彩。 要變更的色彩和調色盤索引是由 色彩 和 索引 參數所指定;新色彩是由 newrgb指定。 此旗標只能由 MCIAVI 數位視訊驅動程式辨識。 要處理的調色盤 控制碼 指定裝置必須用於轉譯的調色盤控制碼。 只有使用調色盤的裝置才支援這個專案。 如果 handle 是零，則會使用預設調色盤。數位視訊裝置不應該釋放使用此命令傳遞的調色盤。 應用程式在關閉裝置之後應該釋出它。 品質 描述項 指定影片錄製到檔案時所執行視訊壓縮的特性。 所有裝置都支援三個描述項：「low」、「medium」 和 「high」。 預設值為裝置特定。 這些名稱的重要性取決於演算法和裝置。 裝置可能會定義其他描述元名稱。 品質命令可用來定義其他描述元名稱。如果未使用「演算法」旗標，描述元會套用至目前的演算法。 錄製畫面播放速率至 速率 設定動作視訊的錄製。 錄製 速率 是以每秒畫面格單位來指定，乘以 1000。 例如，每秒 29.97 個畫面的 NTSC 畫面播放速率會以 29970 表示。 record onrecord off 啟用或停用視訊資料的錄製。 錄製視訊資料是預設值。 記錄追蹤 track_number 關閉 清除視訊來源選取專案，讓下一個 錄製 命令不會錄製任何視訊。 「Track」 允許獨立追蹤選取。 如果未指定 「track」，則會假設預設值為 1。 您可能需要先發出 一組「 組合錄製關閉」命令，才能關閉視訊錄製。 記錄追蹤 track_number 開啟 選取要用下一 個錄製 命令錄製的視訊來源。 「Track」 允許獨立追蹤選取。 追蹤 2 對應至 Hi8 中的 PCM 播放軌。 如果未指定 「track」，則會假設預設值為 1。 因數的尖度 設定視訊尖角等級。 source to source number value 設定視訊輸入的來源。 這通常對應至外部連接器。 針對 來源 定義的常數包括 「rgb」、「pal」、「ntsc」、「svideo」 和 「secam」。 如果指定的型別有多個輸入存在，選擇性的「數位」 值 會指出所需的輸入。 例如， setvideo 「source to ntsc number 2」 會指定第二個 NTSC 輸入。如果省略 「to」 來源 ，則會使用絕對來源，如 清單 「video source」 命令所定義。 source to type number number 選取要錄製在磁帶上的視訊來源。 類型 必須是 「tuner」、「line」、「svideo」、「aux」、「generic」、「mute」 或 「rgb」。 仍然 演算法演算法 指定 擷取 命令所使用的仍然影像壓縮演算法。 每個裝置都必須支援「無 」演算法， 這表示沒有壓縮。 此為預設值。 在此情況下，數位視訊裝置仍會將影像儲存為 RGB 裝置獨立點陣圖。 裝置可能也支援其他演算法的裝置特定清單。 仍然品質 描述項 指定擷取仍在擷取影像時所執行之仍然影像壓縮的特性。 所有裝置都支援描述項「低」、「中」和「高」。 預設值為裝置特定。如果未使用 「algorithm」 旗標， 描述元 會套用至目前的演算法。
品質命令可用來定義其他描述項名稱。資料流程到 數位 指定從工作區播放的視訊串流。 如果未指定資料流程，而且預設資料流程不是由檔案格式定義，則會播放實際第一個交錯的視訊資料流程。 色調到 因素 設定影像色調。 一般而言，這項調整會以許多色彩電視集的色調控制為模型，250 表示綠色、750 表示紅色，以及 0 (或 -
lpszFlags
-
可以是 「等候」、「通知」、「測試」或這些組合。 如需這些旗標的詳細資訊，請參閱 等候、通知和測試旗標。
傳回值
如果成功或發生錯誤，則傳回零。
備註
針對 VCR 裝置，使用 setvideo 搭配旗標來關閉個別追蹤 (「追蹤 track_number 關閉」) 可能會導致您的應用程式收到狀態訊息，指出無法執行命令。某些VCR 只能關閉曲目的組合，而不是個別的曲目;例如，第一個音訊播放軌和視訊播放軌的視訊播放軌。 在此情況下，只要使用 setaudio 和 setvideo 繼續關閉構成組合的其他曲目。 驅動程式會在收到 命令時關閉曲目，以關閉組合中的最後一個曲目。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows 2000 Server [僅限桌面應用程式] |