MCI_PASTE コマンド

  • [アーティクル]

MCI_PASTE コマンドは、クリップボードのデータをファイルに貼り付けます。 デジタル ビデオ デバイスはこのコマンドを認識します。

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_PASTE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_DGV_PASTE_PARMS) lpPaste
);

パラメーター

wDeviceID

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

dwFlags

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

lpPaste

MCI_ DGV_ PASTE_ PARMS 構造体へのポインター。

戻り値

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

解説

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

MCI_DGV_PASTE_AT

lpPaste によって識別される構造体の rc メンバーには、四角形が含まれています。 四角形の最初の 2 つの値は、クリップボード情報を配置するフレーム内のポイントを指定します。 四角形の高さと幅が 0 以外の場合、クリップボードの内容は、フレームに貼り付けられるときに、それらの寸法に合わせて拡大縮小されます。 フラグを省略すると、既定MCI_PASTE枠全体の四角形になります。

MCI_DGV_PASTE_AUDIO_STREAM

オーディオ ストリーム番号は、lpPaste によって識別される構造体の dwAudioStream メンバーに含まれます。 クリップボードに 1 つのオーディオ ストリームのみが存在する場合、オーディオ データは指定されたストリームに貼り付けられます。 クリップボードに複数のオーディオ ストリームが存在する場合、ストリームはストリーム シーケンスの開始番号を示します。 このフラグを使用し、ビデオも貼り付ける場合は、MCI_DGV_PASTE_VIDEO_STREAM フラグも使用する必要があります。 (どちらのフラグも指定しない場合は、最初のオーディオストリームとビデオストリーム以降のすべてのオーディオストリームとビデオストリームが貼り付けされます。貼り付けた各ストリームは、元のストリーム番号を保持します)。

MCI_DGV_PASTE_INSERT

クリップボード データは、MCI_TO フラグで指定された位置にある既存のワークスペースに挿入する必要があります。 挿入ポイントの後に既存のデータがワークスペースに移動され、スペースが作成されます。 既定値です。

MCI_DGV_PASTE_OVERWRITE

クリップボード データは、ワークスペースに既に存在するデータを置き換える必要があります。 置き換えられたワークスペース データは、挿入ポイントに従います。

MCI_DGV_PASTE_VIDEO_STREAM

lpPaste によって識別される構造体の dwVideoStream メンバーには、ビデオ ストリーム番号が含まれています。 クリップボードに 1 つのビデオ ストリームのみが存在する場合、ビデオ データは指定されたストリームに貼り付けられます。 クリップボードに複数のビデオ ストリームが存在する場合、ストリームはストリーム シーケンスの開始番号を示します。 このフラグを使用し、オーディオも貼り付ける場合は、MCI_DGV_PASTE_AUDIO_STREAM フラグも使用する必要があります。 (どちらのフラグも指定しない場合は、最初のオーディオストリームとビデオストリーム以降のすべてのオーディオストリームとビデオストリームが貼り付けされます。貼り付けた各ストリームは、元のストリーム番号を保持します)。

MCI_TO

位置の値は、lpPaste によって識別される構造体の dwTo メンバーに含まれます。 position 値は、ワークスペースへのデータの貼り付け開始位置を指定します。 このフラグを省略すると、位置は既定で現在の位置になります。

必要条件

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

関連項目

Mci

MCI コマンド