put コマンド

  • [アーティクル]

put コマンドは、表示に使用されるソース イメージとコピー先ウィンドウの領域を定義します。 デジタル ビデオおよびビデオ オーバーレイ デバイスは、このコマンドを認識します。

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

_stprintf_s(
  lpszCommand, 
  TEXT("put %s %s %s"), 
  lpszDeviceID, 
  lpszRegions, 
  lpszFlags
);

パラメーター

lpszDeviceID

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

lpszRegions

エリアを定義するためのフラグ。 次の表に、put コマンドと各種類で使用されるフラグを認識するデバイスの種類を示します。

値 説明 説明
digitalvideo 四角形のソースソースにある四角形のフレーム フレームにある変換先の四角形 四角形のウィンドウ ウィンドウのビデオ ビデオ(四角形のウィンドウ のクライアント ウィンドウ クライアントの四角形)
overlay 四角形の枠枠の移動先 四角形のビデオ ビデオのソース ソース (四角形)

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

値 説明
destination データを表示する宛先ウィンドウのクライアント領域全体を選択します。
四角形の宛先 イメージの表示に使用する宛先ウィンドウのクライアント領域の一部を選択します。 表示ウィンドウの領域を指定し、デバイスがストレッチをサポートしている場合、ソース イメージはコピー先のオフセットとエクステントまで拡大されます。
frame 受信ビデオ イメージを受信するフレーム バッファー全体を選択します。
四角形の枠 受信ビデオ イメージを受信するフレーム バッファーの一部を選択します。
source コピー先ウィンドウに表示するイメージ全体を選択します。
四角形のソース コピー先ウィンドウに表示するイメージの一部を選択します。 ソース イメージの領域を指定し、デバイスがストレッチをサポートしている場合、ソース イメージはコピー先のオフセットとエクステントまで拡大されます。
video フレーム バッファーでキャプチャする受信ビデオ イメージ全体を選択します。
四角形のビデオ フレーム バッファーでキャプチャする受信ビデオ イメージの一部を選択します。
window ディスプレイの初期ウィンドウ サイズを復元します。 このコマンドでは、ウィンドウも表示されます。
四角形のウィンドウ 表示ウィンドウのサイズと場所を変更します。 指定した四角形は、 開 いているコマンドに "style child" フラグが使用されている場合、表示ウィンドウの親ウィンドウ (通常はデスクトップ) に対する相対位置です。 ウィンドウの高さまたは幅を変更せずにウィンドウの位置を変更するには、高さと幅に 0 を指定します。
window クライアント ウィンドウのクライアント領域を復元します。
四角形のウィンドウ クライアント ウィンドウのクライアント領域のサイズと場所を変更します。 指定した四角形は、クライアント ウィンドウの親ウィンドウを基準にしています。 ウィンドウの高さまたは幅を変更せずにウィンドウの位置を変更するには、高さと幅に 0 を指定します。

フラグに四角形が含まれている場合、四角形の座標はウィンドウの原点または画像の原点を基準にして、必要に応じて X1 Y1 X2 Y2 として指定されます。 座標 X1Y1 は左上隅を指定し、座標 X2Y2 は四角形の幅と高さを指定します。

lpszFlags

"wait"、"notify"、またはその両方を指定できます。 デジタル ビデオ デバイスの場合は、"テスト" を指定することもできます。 これらのフラグの詳細については、「 待機、通知、テスト フラグ」を参照してください。

戻り値

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

解説

put コマンドは、ビデオ オーバーレイ デバイスを操作するときに、次の四角形の 1 つ以上を定義します。

  • ビデオの四角形は、キャプチャする受信ビデオ イメージの領域を定義します。
  • フレーム四角形は、受信ビデオ イメージを受信するフレーム バッファーの領域を定義します。
  • ソース四角形は、フレーム バッファーのどの領域をコピー先の四角形にコピーするかを定義します。
  • 変換先の四角形は、ビデオ イメージを受け取る表示ウィンドウ クライアント領域の領域を定義します。

ビデオの四角形は、ソース四角形が変換先の四角形に関連付けられているのと同じ方法で、フレームの四角形に関連しています。 ストレッチは、ビデオの四角形からフレームの四角形、およびソースの四角形から目的の四角形に行うことができます。 すべてのデバイスでストレッチがサポートされているわけではありません。また、( set コマンドを使用して) ストレッチを有効にする必要があります。

次のコマンドは、ビデオ、フレーム、ソースの 3 つのリージョンを定義します。

put vboard video 120 120 200 200 frame 0 0 200 200 source 0 0 200 200

この例のリージョンは、次のように定義されています。

  • 受信ビデオ データの 200 x 200 ピクセルの領域が、左上隅から 120 ピクセルの原点から開始され、フレーム バッファーにキャプチャされます。
  • ビデオ データは、フレーム バッファーの左上隅にある 200 x 200 ピクセルの領域に配置されます。
  • 転送は、フレーム バッファーの左上隅にある 200 x 200 ピクセルの領域から宛先ウィンドウに送信されます。

必要条件

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

関連項目

Mci

MCI コマンド文字列

open

set