MCI_QUALITY コマンド

MCI_QUALITY コマンドは、オーディオ、ビデオ、または静止画像データ圧縮のカスタム品質レベルを定義します。 デジタル ビデオ デバイスはこのコマンドを認識します。

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_QUALITY, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_DGV_QUALITY_PARMS) lpQuality
);

パラメーター

wDeviceID

コマンド メッセージを受信する MCI デバイスのデバイス識別子。

dwFlags

MCI_NOTIFY、MCI_WAIT、またはMCI_TEST。 これらのフラグの詳細については、「 待機、通知、およびテスト フラグ」を参照してください。

lpQuality

MCI_DGV_QUALITY_PARMS構造体へのポインター。

戻り値

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

解説

この品質レベルに定義されている名前は、 MCI_SETAUDIO コマンドと MCI_SETVIDEO コマンドでオーディオ、ビデオ、または引き続き品質を設定するときに使用できます。

デジタル ビデオ デバイスには、次の追加フラグが適用されます。

MCI_QUALITY_ALG

lpQuality によって識別される構造体の lpstrAlgorithm メンバーには、アルゴリズムの名前を含むバッファーのアドレスが含まれています。 このアルゴリズムは、デバイス ドライバーでサポートされている必要があり、使用されているオーディオ記述子、引き続き、またはビデオ記述子と互換性がある必要があります。 このフラグを省略すると、現在のアルゴリズムが使用されます。

MCI_QUALITY_DIALOG

デバイス ドライバーには、品質レベルを指定するためのダイアログ ボックスが表示されます。 ダイアログ ボックスには、特定の品質レベルを記述する構造を作成するために、デバイス ドライバーによって内部的に使用されるアルゴリズム固有のフィールドがあります。

MCI_QUALITY_HANDLE

lpQuality によって識別される構造体の dwHandle メンバーには、構造体へのハンドルが含まれています。 構造体には、特定の品質レベルを記述するアルゴリズム固有のデータが含まれています。 アルゴリズムの構造体の形式はデバイスによって異なります。

MCI_QUALITY_ITEM

アルゴリズムの種類を示す定数は、lpQuality によって識別される構造体の dwItem メンバーに含まれます。

MCI_QUALITY_NAME

lpQuality によって識別される構造体の lpstrName メンバーには、品質記述子を含むバッファーのアドレスが含まれています。

必要条件

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

関連項目

Mci

MCI コマンド