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 [デスクトップ アプリのみ] |
| ヘッダー |
|