MCI_WHERE コマンド

  • [アーティクル]

MCI_WHERE コマンドは、ビデオ デバイスのクリッピング四角形を取得します。 デジタル ビデオおよびビデオ オーバーレイ デバイスは、このコマンドを認識します。 返される RECT の上と左のメンバーにはクリッピング四角形の原点が含まれており、右と下のメンバーにはクリッピング四角形の幅と高さが含まれます。 (これは、 右 と 下 のメンバーの標準的な使用ではありません。

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_WHERE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpQuery
);

パラメーター

wDeviceID

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

dwFlags

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

lpQuery

MCI_GENERIC_PARMS構造体へのポインター。 (拡張コマンド セットを持つデバイスは、この構造体をデバイス固有の構造に置き換える場合があります)。

戻り値

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

解説

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

MCI_DGV_WHERE_DESTINATION

現在のウィンドウのクライアント領域にビデオと画像を表示するために使用される四角形領域の説明を取得します。

MCI_DGV_WHERE_FRAME

ビデオの四角形から画像をスケーリングするフレーム バッファーの四角形領域の説明を取得します。 四角形の座標は、lpQuery で識別される構造体の rc メンバーに配置されます。

MCI_DGV_WHERE_MAX

MCI_DGV_WHERE_DESTINATIONまたはMCI_DGV_WHERE_SOURCEと共に使用すると、返される四角形は、指定した領域の最大幅と高さを示します。 MCI_DGV_WHERE_WINDOWと共に使用すると、返される四角形は表示全体のサイズを示します。

MCI_DGV_WHERE_SOURCE

ディスプレイ上の移動先の四角形に合わせて引き伸ばされる四角形領域 (フレーム バッファーからトリミング) の説明を取得します。

MCI_DGV_WHERE_VIDEO

プレゼンテーション ソースからトリミングされた四角形領域の説明を取得して、フレーム バッファー内のフレーム四角形を塗りつぶします。 四角形の座標は、lpQuery で識別される構造体の rc メンバーに配置されます。

MCI_DGV_WHERE_WINDOW

表示ウィンドウ フレームの説明を取得します。

デジタル ビデオ デバイスの場合、 lpQuery パラメーターは MCI_DGV_WHERE_PARMS 構造体を指します。 MCI_DGV_WHERE_PARMS構造体は、MCI_DGV_RECT_PARMS構造体と同じです。

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

MCI_OVLY_WHERE_DESTINATION

表示先の四角形を取得します。 四角形の座標は、lpQuery で識別される構造体の rc メンバーに配置されます。

MCI_OVLY_WHERE_FRAME

オーバーレイ フレームの四角形を取得します。 四角形の座標は、lpQuery で識別される構造体の rc メンバーに配置されます。

MCI_OVLY_WHERE_SOURCE

ソース四角形を取得します。 四角形の座標は、lpQuery で識別される構造体の rc メンバーに配置されます。

MCI_OVLY_WHERE_VIDEO

ビデオの四角形を取得します。 四角形の座標は、lpQuery で識別される構造体の rc メンバーに配置されます。

ビデオ オーバーレイ デバイスの場合、 lpQuery パラメーターは MCI_OVLY_RECT_PARMS 構造体を指します。

必要条件

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

関連項目

Mci

MCI コマンド