MCI_PUT コマンド

  • [アーティクル]

MCI_PUT コマンドは、ソース、変換先、フレームの四角形を設定します。 デジタル ビデオおよびビデオ オーバーレイ デバイスは、このコマンドを認識します。

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_PUT, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpDest
);

パラメーター

wDeviceID

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

dwFlags

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

lpDest

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

戻り値

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

解説

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

MCI_DGV_PUT_CLIENT

MCI_DGV_RECTに定義されている四角形は、クライアント ウィンドウの位置に適用されます。 指定された四角形は、表示ウィンドウの親ウィンドウを基準にしています。 MCI_DGV_PUT_WINDOWは、このフラグと同時に設定する必要があります。

MCI_DGV_PUT_DESTINATION

MCI_DGV_RECTに定義されている四角形は、変換先の四角形を指定します。 変換先の四角形は、イメージまたはビデオを示すこのデバイス ドライバー インスタンスに関連付けられているクライアント ウィンドウの部分を指定します。

MCI_DGV_PUT_FRAME

MCI_DGV_RECTに定義されている四角形は、フレームの四角形に適用されます。 フレームの四角形は、ビデオの四角形から取得されたビデオ 画像の宛先として使用されるフレーム バッファーの部分を指定します。 ビデオは、フレーム バッファーの四角形内に収まるようにスケーリングする必要があります。

四角形は、フレーム バッファー座標で指定されます。 既定の四角形は、フル フレーム バッファーです。 この四角形を指定すると、デバイスはデータのデジタル化に合わせてイメージをスケーリングできます。 イメージをスケーリングできないデバイスは、MCIERR_UNSUPPORTED_FUNCTIONを使用してこのコマンドを拒否します。 MCI_GETDEVCAPS コマンドで MCI_GETDEVCAPS_CAN_STRETCH フラグを使用して、デバイスがイメージをスケーリングするかどうかを判断できます。 イメージをスケーリングできない場合、デバイスは FALSE を 返します。

MCI_DGV_PUT_SOURCE

MCI_DGV_RECTに定義されている四角形は、ソースの四角形を指定します。 ソースの四角形は、フレーム バッファーのどの部分を、目的の四角形に収まるようにスケーリングするかを指定します。

MCI_DGV_PUT_VIDEO

MCI_DGV_RECTに定義されている四角形は、ビデオの四角形に適用されます。 ビデオの四角形は、現在のプレゼンテーション ソースのどの部分をフレーム バッファーに格納するかを指定します。 四角形は、プレゼンテーション ソースの自然な座標を使用して指定されます。 これにより、フレーム バッファーに画像とビデオを格納する前に発生するトリミングを指定できます。 既定の四角形は、アクティブなスキャン領域全体、または完全に圧縮解除された画像とビデオです。

MCI_DGV_PUT_WINDOW

MCI_DGV_RECTに定義されている四角形は、表示ウィンドウに適用されます。 この四角形は、表示ウィンドウ (通常はデスクトップ) の親ウィンドウを基準にしています。 ウィンドウが指定されていない場合は、既定で初期ウィンドウのサイズと位置が設定されます。

MCI_DGV_RECT

lpDest で識別される構造体の rc メンバーには、有効な四角形が含まれています。

デジタル ビデオ デバイスの場合、 lpDest は MCI_DGV_PUT_PARMS 構造を指します。

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

MCI_OVLY_PUT_DESTINATION

MCI_OVLY_RECTに定義された四角形は、イメージの表示に使用されるクライアント ウィンドウの領域を指定します。 四角形には、ウィンドウの原点に対するイメージのオフセットと表示範囲が含まれます。 フレームが引き伸ばされている場合、ソースはターゲットの四角形に引き伸ばされます。

MCI_OVLY_PUT_FRAME

MCI_OVLY_RECTに定義されている四角形は、ビデオ イメージの受信に使用されるビデオ バッファーの領域を指定します。 四角形には、ビデオ バッファーの原点に対するバッファー領域のオフセットと範囲が含まれています。

MCI_OVLY_PUT_SOURCE

MCI_OVLY_RECTに定義されている四角形は、デジタル 画像のソースとして使用されるビデオ バッファーの領域を指定します。 四角形には、ビデオ バッファーの原点に対するクリッピング四角形のオフセットと範囲が含まれます。

MCI_OVLY_PUT_VIDEO

MCI_OVLY_RECTに定義された四角形は、ビデオ バッファーによるビデオ ソース キャプチャの領域を指定します。 四角形には、ビデオ ソースの原点を基準としたクリッピング四角形のオフセットと範囲が含まれます。

MCI_OVLY_RECT

lpDest で識別される構造体の rc メンバーには、有効な表示四角形が含まれています。 このフラグを指定しない場合、既定の四角形は、クリップされるビデオ バッファーまたはウィンドウの座標と一致します。

ビデオ オーバーレイ デバイスの場合、 lpDest は MCI_OVLY_RECT_PARMS 構造体を指します。

必要条件

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

関連項目

Mci

MCI コマンド