setvideo コマンド

[アーティクル]
06/13/2023

setvideo コマンドは、ビデオの再生とキャプチャに関連付けられている値を設定します。デジタルビデオおよび VCR デバイスはこのコマンドを認識します。

このコマンドを送信するには、lpszCommand パラメーターを次のように設定して mciSendString 関数を呼び出します。

_stprintf_s(
  lpszCommand, 
  TEXT("setvideo %s %s %s"), 
  lpszDeviceID, 
  lpszVideo, 
  lpszFlags
);

パラメーター

lpszDeviceID

MCI デバイスの識別子。この識別子またはエイリアスは、デバイスを開いたときに割り当てられます。

lpszVideo

ビデオの再生とキャプチャのフラグを設定します。次の表に、 setvideo コマンドを認識するデバイスの種類と、各種類で使用されるフラグを示します。

値	説明	説明
digitalvideo	アルゴリズムアルゴリズムbitsperpel を使用して明るさをカウントして clocktimecolor を係数化し、値に対するガンマ因子のコントラストを halftoneinputkey 色から r:g:bキーインデックスから offonoutput のインデックスに因数化する	インデックスを基準にした期間パレットの色を newrgb パレットハンドルに渡して、品質記述子レコードのフレームレートを処理して、ソースからソース番号への係数を引き続きアルゴリズムアルゴリズムに基づいてオフシャープネスでレコードオフシャープネスをレートする
ビデオデッキ	オフレコードトラックの番号レコードを入力する offonmonitor track_numberオフ	レコードオンレコードトラックtrack_numberオフトラックtrack_numbertrack_number番号トラックを入力するオンソース

次の表に、 lpszVideo パラメーターで指定できるフラグとその意味を示します。

値	説明
アルゴリズムアルゴリズム	後続の予約コマンドまたはレコードコマンドで使用するビデオ圧縮アルゴリズムを指定します。デバイスでサポートされるアルゴリズムは、デバイス固有です。 MCI は、アルゴリズムの定数 "mpeg" と "h261" を定義します。指定したアルゴリズムが現在のファイル形式と競合する場合、ファイル形式はアルゴリズムの既定の形式に変更されます。
カウントする bitsperpel	capture または record コマンドを使用してデータを保存するための 1 ピクセルあたりのビット数を設定します。
要因に明るさ	ビデオの明るさレベルを設定します。
clocktime	"over" フラグで指定された時間がミリ秒単位であることを示します。時間は絶対であり、ワークスペースの再生に伴うステップではありません。
要素に色を設定する	彩度レベルを設定します。
要因に対するコントラスト	ビデオコントラストレベルを設定します。
値へのガンマ	ガンマ補正指数に 1000 を乗算して指定します。たとえば、指数部 2.2 を指定するには、値に 2200 を使用します。 1.0 (1000) のガンマ値は、ガンマ補正が適用されていないことを示します。ガンマ補正は、プレゼンテーションソースでエンコードされた強度と表示される明るさのマッピングを調整します。
ハーフトーン	既定のパレットの代わりにハーフトーンパレットを使用します。このフラグは、MCIAVI デジタルビデオドライバーによってのみ認識されます。
input	"明るさ"、"色"、"コントラスト"、"ガンマ"、"シャープネス"、または "濃淡" フラグを変更して、入力信号に影響を与え、記録される内容を変更します。可能であれば、入力を監視する場合の既定値です。
r:g:b に対するキーの色	キーの色を設定します。 r:g:b 変数は RGB 値です。コロン (:)個々の赤、緑、青の値を区切ります。
インデックスへのキーインデックス	キーインデックスを設定します。 index 変数は、物理パレットインデックスです。
番号を入力するモニター	録音ソース入力の選択を変更せずに、VCR 出力に渡すソース入力を制御します。型には、"output" または有効な入力ソースのいずれかを指定できます。 "number" が指定されていない場合は、その型の最初の入力が選択されます。
offon	ビデオの表示を有効または無効にします。ビデオを無効にすると、 put "destination" 四角形 (またはその既定の現在のウィンドウのクライアント領域) のピクセルが純色に設定されます。フレームバッファーには影響しません。ワークスペースでも外部入力でも、ビデオソースは、フレームバッファーに新しいイメージを格納し続ける可能性があります。ビデオが有効になるまでは表示されません。ウィンドウの "state" コマンドを使用して、ウィンドウを非表示にすることができます。既定値は setvideo "on" です。
output	"明るさ"、"色"、"コントラスト"、"ガンマ"、"シャープネス"、または "濃淡" フラグを変更して、表示される信号のみを変更し、記録される内容を変更しないようにします。可能であれば、ファイルを監視する場合の既定値です。
期間を超える	因子変数を使用する変更に要する時間を指定します。期間の単位は現在の時刻形式です。変更は、ワークスペースの再生に伴うステップで行われます。再生が中断されると、プレイが続行されるまで変更も中断されます。 "over" が使用されていないか、サポートされていない場合、変更はすぐに行われます。
インデックスを newrgb に対するパレットの色	新しいパレットの色を設定します。変更する色とパレットのインデックスは、色とインデックスのパラメーターによって指定されます。新しい色は newrgb によって指定されます。このフラグは、MCIAVI デジタルビデオドライバーによってのみ認識されます。
処理するパレットハンドル	デバイスがレンダリングに使用する必要があるパレットへのハンドルを指定します。このアイテムは、パレットを使用するデバイスでのみサポートされています。 handle が 0 の場合は、既定のパレットが使用されます。デジタルビデオデバイスは、このコマンドで渡されたパレットを解放しないでください。アプリケーションは、デバイスを閉じてから解放する必要があります。
品質記述子	ビデオがファイルに記録されるときに実行されるビデオ圧縮の特性を指定します。すべてのデバイスは、"low"、"medium"、"high" の 3 つの記述子をサポートしています。既定値はデバイス固有です。これらの名前の重要性は、アルゴリズムとデバイスによって異なります。デバイスは、追加の記述子名を定義する場合があります。 quality コマンドを使用して、追加の記述子名を定義できます。"algorithm" フラグが使用されていない場合、記述子は現在のアルゴリズムに適用されます。
フレームレートをレートに記録する	モーションビデオの記録を設定します。記録レートは、1 秒あたりのフレーム数に 1000 を乗算して指定します。たとえば、1 秒あたり 29.97 フレームの NTSC フレームレートは 29970 として表されます。
レコードオンレコードオフ	ビデオデータの記録を有効または無効にします。ビデオデータの記録が既定です。
レコードトラック track_number オフ	次の record コマンドでビデオが記録されないように、ビデオソースの選択をクリアします。「トラック」は独立したトラック選択を可能にする。 "track" が指定されていない場合は、既定値の 1 が想定されます。ビデオ録画をオフにする前に、最初にセットの "アセンブルレコードオフ" コマンドを発行する必要がある場合があります。
レコードトラック track_number	次の record コマンドで記録するビデオソースを選択します。「トラック」は独立したトラック選択を可能にする。トラック2はHi8のPCMトラックに対応しています。 "track" が指定されていない場合は、既定値の 1 が想定されます。
因数に対するシャープネス	ビデオの鮮明度レベルを設定します。
source から source number の値	ビデオ入力のソースを設定します。これは通常、外部コネクタに対応します。 source に定義されている定数には、"rgb"、"pal"、"ntsc"、"svideo"、および "secam" があります。指定した型の入力が複数存在する場合、省略可能な "number" 値は目的の入力を示します。たとえば、 setvideo "source to ntsc number 2" は、2 番目の NTSC 入力を指定します。"to" ソースを省略すると、リスト "video source" コマンドで定義されているとおりに絶対ソースが使用されます。
source to typenumber	テープに記録するビデオソースを選択します。種類は、"チューナー"、"line"、"svideo"、"aux"、"generic"、"mute"、または "rgb" である必要があります。
引き続きアルゴリズムアルゴリズム	capture コマンドで使用される静止画像圧縮アルゴリズムを指定します。すべてのデバイスで "none" のアルゴリズムがサポートされている必要があります。これは、圧縮がないことを意味します。既定値です。この場合、デジタルビデオデバイスは、静止画像を RGB デバイスに依存しないビットマップとして保存します。デバイスでは、追加のアルゴリズムのデバイス固有の一覧もサポートされている場合があります。
引き続き品質記述子	静止画像のキャプチャ中に実行される静止画像圧縮の特性を指定します。すべてのデバイスは、記述子 "low"、"medium"、"high" をサポートしています。既定値はデバイス固有です。"algorithm" フラグが使用されていない場合、記述子は現在のアルゴリズムに適用されます。 quality コマンドを使用して、他の記述子名を定義できます。
stream to number	ワークスペースから再生されるビデオストリームを指定します。ストリームが指定されておらず、既定のストリームがファイル形式で定義されていない場合は、物理的に最初にインターリーブされたビデオストリームが再生されます。
要素に濃淡	イメージの濃淡を設定します。通常、この調整は、250 が緑、750 が赤色、0 (または

lpszFlags

"wait"、"notify"、"test"、またはこれらの組み合わせを指定できます。これらのフラグの詳細については、「待機、通知、テストフラグ」を参照してください。

戻り値

成功した場合は 0 を返し、それ以外の場合はエラーを返します。

解説

VCR デバイスの場合、setvideo を個々のトラックをオフにするフラグ ("トラック track_number オフ") を使用すると、アプリケーションがコマンドを実行できなかったことを示すステータスメッセージを受信する可能性があります。一部の VCR では、個々のトラックではなく、トラックの組み合わせのみをオフにできます。たとえば、最初のオーディオトラックとビデオカセットのビデオトラックなどです。この場合は、 setaudio と setvideo を使用して、組み合わせを構成する他のトラックをオフにし続けます。ドライバーは、組み合わせの最後のトラックをオフにするコマンドを受け取ると、トラックをオフにします。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]

次の方法で共有

setvideo コマンド

パラメーター

戻り値

解説

要件

関連項目

フィードバック

その他のリソース