MCI_SETVIDEO コマンド

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

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

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_SETVIDEO, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpSetVideo
);

パラメーター

wDeviceID: コマンドメッセージを受信する MCI デバイスのデバイス識別子。
dwFlags: MCI_NOTIFY、 MCI_WAIT、または MCI_TEST。これらのフラグの詳細については、「待機、通知、およびテストフラグ」を参照してください。
lpSetVideo: MCI_GENERIC_PARMS構造体へのポインター。 (拡張コマンドセットを持つデバイスは、この構造体をデバイス固有の構造に置き換える場合があります)。

戻り値

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

解説

"digitalvideo" デバイスの種類では、次の追加フラグが使用されます。

MCI_DGV_SETVIDEO_ALG

lpSetVideo によって識別される構造体の lpstrAlgorithm メンバーには、ビデオ圧縮アルゴリズムの名前を含むバッファーのアドレスが含まれています。圧縮アルゴリズムは、後続の MCI_RESERVE または MCI_RECORD コマンドで使用されます。使用可能なアルゴリズムはデバイスに依存します。

指定したアルゴリズムが現在のファイル形式と互換性がない場合、ファイル形式はアルゴリズムの既定の形式に変更されます。

MCI_DGV_SETVIDEO_CLOCKTIME

MCI_DGV_SETVIDEO_OVERと共に使用する場合、は時間がミリ秒単位で指定され、絶対時間であることを示します。 (今回は、ワークスペースの再生に関する手順ではありません。)

MCI_DGV_SETVIDEO_INPUT

MCI_DGV_SETVIDEO_BRIGHTNESS、MCI_DGV_SETVIDEO_COLOR、MCI_DGV_SETVIDEO_CONTRAST、MCI_DGV_SETVIDEO_GAMMA、MCI_DGV_SETVIDEO_SHARPNESS、またはMCI_DGV_SETVIDEO_TINTを変更して、入力信号に影響を与え、記録される内容を変更します。可能であれば、入力を監視する場合の既定値です。

MCI_DGV_SETVIDEO_ITEM

ビデオ定数は、lpSetVideo によって識別される構造体の dwItem メンバーで指定されます。定数は、設定されている値を識別します。このフラグを使用して、次の定数を指定できます。

MCI_AVI_SETVIDEO_DRAW_PROCEDURE

lpSetVideo で識別される構造体の dwValue メンバーに、新しい描画プロシージャアドレスが指定されます。デバイスがアイドル状態の場合にのみ、新しい描画プロシージャを指定できます。このフラグは、MCIAVI デジタルビデオドライバーによってのみ認識されます。文字列コマンドインターフェイスには、このフラグに相当するものはありません。

MCI_AVI_SETVIDEO_PALETTE_COLOR

lpSetVideo によって識別される構造体の dwOver メンバーと dwValue メンバーに、新しいパレットの色が指定されます。 dwOver メンバーは、変更する色のパレットインデックスを指定し、dwValue メンバーは新しい色を RGB 値として指定します。この定数を使用する場合は、 MCI_DGV_SETVIDEO_OVER フラグと MCI_DGV_SETVIDEO_VALUE フラグを MCI_DGV_SETVIDEO_ITEM で指定する必要もあります。このフラグは、MCIAVI デジタルビデオドライバーによってのみ認識されます。

MCI_AVI_SETVIDEO_PALETTE_HALFTONE

既定のパレットではなく、ハーフトーンパレットを使用する必要があることを示します。このフラグは、MCIAVI デジタルビデオドライバーによってのみ認識されます。

MCI_DGV_SETVIDEO_BITSPERPEL

ピクセルあたりのビット数は、lpSetVideo によって識別される構造体の dwValue メンバーで指定されます。キャプチャまたは記録されたデータを保存するために、ピクセルあたりのビット数が使用されます

MCI_DGV_SETVIDEO_BRIGHTNESS

ビデオの明るさレベルは、lpSetVideo によって識別される構造体の dwValue メンバーの係数として指定されます。

MCI_DGV_SETVIDEO_COLOR

ビデオの色の彩度レベルは、lpSetVideo によって識別される構造体の dwValue メンバーの係数として指定されます。

MCI_DGV_SETVIDEO_CONTRAST

ビデオコントラストレベルは、lpSetVideo によって識別される構造体の dwValue メンバーの係数として指定されます。

MCI_DGV_SETVIDEO_FRAME_RATE

フレームレートは、lpSetVideo によって識別される構造体の dwValue メンバーで指定されます。レートは、1 秒あたり 1000 回のフレームの単位で指定されます。たとえば、1 秒あたり 29.97 フレームは 29970 として指定されます。

MCI_DGV_SETVIDEO_GAMMA

ガンマ補正指数値は、lpSetVideo によって識別される構造体の dwValue メンバーで指定されます。ガンマ補正は、プレゼンテーションソースでエンコードされた強度と表示される明るさの間のマッピングを調整します。値は、指数部に 1000 を掛けた値です。たとえば、2200 は 2.2 の指数を示します。値 1000 は、ガンマ補正を適用しない 1 の指数を示します。

MCI_DGV_SETVIDEO_KEY_COLOR

キーの色は、lpSetVideo によって識別される構造体の dwValue メンバーで指定されます。キーの色は RGB 値です。

MCI_DGV_SETVIDEO_KEY_INDEX

lpSetVideo で識別される構造体の dwValue メンバーに、キーインデックス値が指定されています。 index パラメーターは、物理パレットインデックスです。

MCI_DGV_SETVIDEO_PALHANDLE

パレットハンドルは、lpSetVideo によって識別される構造体の dwValue メンバーで指定されます。パレットハンドルは、下位ワードに含まれています。デジタルビデオデバイスは、このコマンドで渡されたパレットを解放しないでください。アプリケーションは、デバイスを閉じてから解放する必要があります。このフラグは、パレットを使用するデバイスでのみサポートされます。この指定したパレットハンドルが 0 の場合は、既定のパレットが使用されます。

MCI_DGV_SETVIDEO_SHARPNESS

ビデオの鮮明度の値は、lpSetVideo によって識別される構造体の dwValue メンバーの係数として指定されます。

MCI_DGV_SETVIDEO_SOURCE

ビデオ入力のソースを指定する定数は、lpSetVideo によって識別される構造体の dwValue メンバーで指定されます。次の定数が定義されています。

MCI_DGV_SETVIDEO_SRC_NTSC: NTSC テレビ。
MCI_DGV_SETVIDEO_SRC_PAL: PAL テレビ。
MCI_DGV_SETVIDEO_SRC_RGB: RGB ビデオ。
MCI_DGV_SETVIDEO_SRC_SECAM: SECAM テレビ。
MCI_DGV_SETVIDEO_SRC_SVIDEO: S-Video。

MCI_DGV_SETVIDEO_STREAM

ビデオストリームは、lpSetVideo で識別される構造体の dwValue メンバーで指定されます。整数値は、ワークスペースから再生されるビデオストリームを指定します。ストリームが指定されておらず、ファイル形式で既定のストリームが定義されていない場合は、最初の物理的にインターリーブされたビデオストリームが再生されます。

MCI_DGV_SETVIDEO_TINT

ビデオの濃淡の値は、lpSetVideo によって識別される構造体の dwValue メンバーの要素として指定されます。通常、この調整は、多くのカラーテレビセットの濃淡コントロールの後にモデル化されます。250 は緑、750 は赤、0 (または 1000) は青として定義されます。名目値は常に 500 です。

MCI_DGV_SETVIDEO_OUTPUT

MCI_DGV_SETVIDEO_BRIGHTNESS、MCI_DGV_SETVIDEO_COLOR、MCI_DGV_SETVIDEO_CONTRAST、MCI_DGV_SETVIDEO_GAMMA、MCI_DGV_SETVIDEO_SHARPNESS、またはMCI_DGV_SETVIDEO_TINT フラグが変更され、表示されるシグナルのみに影響し、記録される内容には影響しません。可能であれば、ファイルを監視する場合の既定値です。

MCI_DGV_SETVIDEO_OVER

遷移長パラメーターは、lpSetVideo によって識別される構造体の dwOver メンバーに含まれています。切り替えの長さは、変更に要する時間 (現在の時刻形式) を指定します。このフラグを使用しない場合、変更はすぐに行われます。

MCI_DGV_SETVIDEO_QUALITY

lpSetVideo によって識別される構造体の lpstrQuality メンバーには、ビデオ品質を記述するバッファーのアドレスが含まれています。バッファー内のテキスト文字列は、ビデオ圧縮アルゴリズムの特性を指定します。

MCI_DGV_SETVIDEO_ALG フラグを使用して、指定したアルゴリズムの品質記述子を選択できます。このフラグを省略すると、現在のアルゴリズムが使用されます。

使用できるアルゴリズムと記述子の名前は、デバイスによって異なります。各デバイスには、使用可能なアルゴリズムのドキュメントと、該当する記述子名の説明が用意されています。 MCI_QUALITY コマンドでは、追加の記述子名を定義できます。すべてのデバイスは、記述子 "low"、"medium"、"high" をサポートしています。既定値はドライバー固有です。

MCI_DGV_SETVIDEO_RECORD

録画にビデオデータを含めるか除外するかを指定します。 MCI_SET_ONと組み合わせると、ビデオデータが記録されます。 MCI_SET_OFFと組み合わせると、ビデオデータは除外されます。既定値にはビデオデータが含まれます。

MCI_DGV_SETVIDEO_SRC_NUMBER

ビデオソースの数値は、lpSetVideo によって識別される構造体の dwSourceNumber メンバーで指定されます。 MCI_DGV_SETVIDEO_VALUEで指定された型の入力が複数ある場合、値によって入力が選択されます。このフラグは常に MCI_DGV_SETVIDEO_SOURCEで使用する必要があります。ただし 、MCI_DGV_SETVIDEO_VALUE を省略した場合、指定したソース番号は、 MCI_LIST コマンドで指定したとおりに使用する絶対ソースを示します。

MCI_DGV_SETVIDEO_STILL

指定されたアルゴリズム名または品質値は、静止画像に適用されます。

すべてのデバイスドライバーは、圧縮がないことを意味する "none" のアルゴリズムをサポートする必要があります。既定値です。この場合、デジタルビデオデバイスは、静止画像を RGB デバイスに依存しないビットマップ (DIB) として保存します。

MCI_DGV_SETVIDEO_VALUE

値は、lpSetVideo によって識別される構造体の dwValue メンバーに含まれます。値の意味は、 MCI_DGV_SETVIDEO_ITEM フラグで指定します。

MCI_SET_OFF

ビデオ出力を無効にします。デジタルビデオデバイスの場合、ビデオを無効にすると、 MCI_PUT コマンドによって定義された変換先の四角形のピクセル (または既定の現在のウィンドウのクライアント領域) が単色に設定されますが、フレームバッファーには影響しません。必要に応じて、 MCI_WINDOW コマンドを使用してウィンドウを非表示にすることができます。ワークスペースでも外部入力でも、ビデオのソースはフレームバッファーに新しい画像を保存し続ける可能性がありますが、ビデオが有効になるまで表示されません。アプリケーションでは MCI_SETVIDEO コマンドを使用してこの機能を制御する必要があります。ただし、デジタルビデオデバイスでは引き続きこのフラグをサポートする必要があります。開いた後の既定値はオンです。

MCI_SET_ON

ビデオ出力を有効にします。

デジタルビデオデバイスの場合、 lpSetVideo パラメーターは MCI_DGV_SETVIDEO_PARMS 構造体を指します。

"vcr" デバイスの種類では、次の追加フラグが使用されます。

MCI_VCR_SETVIDEO_RECORD

ビデオ録画をオンまたはオフに設定します。次のいずれかのフラグと組み合わせて使用します。

MCI_SET_ON。ビデオ録画オン。
MCI_SET_OFF。ビデオ録画をオフにします。ビデオ録画をオフにする前に、最初にアセンブル記録をオフにする ( MCI_VCR_SET_ASSEMBLE_RECORD フラグをオフにした 状態でMCI_SET コマンドを使用する) 必要がある場合があります。

MCI_TRACK

lpSetVideo によって識別される構造体の dwTrack メンバーは、コマンドの影響を受けるトラックを指定します。

MCI_VCR_SETVIDEO_SOURCE

ビデオソースを設定し、 MCI_VCR_SETVIDEO_TO フラグと共に使用する必要があります。

MCI_VCR_SETVIDEO_MONITOR

ビデオソースモニターを設定し、MCI_VCR_SETVIDEO_TO フラグと共に使用する必要があります。

MCI_VCR_SETVIDEO_TO

lpSetVideo によって識別される構造体の dwTo メンバーには、次のいずれかの定数が含まれています。

**MCI\_VCR\_SRC\_TYPE\_TUNER**

**MCI\_VCR\_SRC\_TYPE\_LINE**

**MCI\_VCR\_SRC\_TYPE\_AUX**

**MCI\_VCR\_SRC\_TYPE\_GENERIC**

**MCI\_VCR\_SRC\_TYPE\_MUTE**

**MCI\_VCR\_SRC\_TYPE\_OUTPUT**

**MCI\_VCR\_SRC\_TYPE\_RGB**

**MCI\_VCR\_SETVIDEO\_NUMBER**

lpSetVideo によって識別される構造体の dwNumber メンバーには、使用するビデオ入力 (dwTo メンバーで指定された型) が含まれています。

VCR デバイスの場合、 lpSetVideo パラメーターは MCI_VCR_SETVIDEO_PARMS 構造体を指します。

必要条件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
ヘッダー	Mmsystem.h (Windows.h を含む)

次の方法で共有

MCI_SETVIDEO コマンド

パラメーター

戻り値

解説

必要条件

関連項目

フィードバック

その他のリソース