paste コマンド

  • [アーティクル]

paste コマンドは、クリップボードの内容をワークスペースにコピーします。 デジタル ビデオ デバイスはこのコマンドを認識します。

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

_stprintf_s(
  lpszCommand, 
  TEXT("paste %s %s %s"), 
  lpszDeviceID, 
  lpszItem, 
  lpszFlags
);

パラメーター

lpszDeviceID

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

lpszItem

次のフラグのうち 1 つ以上。

値 説明
四角形 データを貼り付けるフレーム内の場所を指定します。 四角形の左上隅は、追加されたデータの左上隅に対応します。 四角形のサイズが X または Y の 0 以外の場合、クリップボードの内容は、フレームに貼り付けると、それらのサイズで拡大縮小されます。 省略すると、 四角形 は既定でフレーム全体に設定されます。 このフラグが "挿入" モード (既定値) で指定されている場合、四角形の外側の領域は単色で塗りつぶされます。
オーディオ ストリーム ストリーム コマンドの影響を受けるワークスペース内のオーディオ ストリームを指定します。 クリップボードに 1 つのオーディオ ストリームのみが存在する場合、オーディオ データは指定されたストリームに貼り付 けられます。 クリップボードに複数のオーディオ ストリームが存在する場合、ストリームは ストリーム シーケンスの開始番号を示します。 このフラグを使用し、ビデオを貼り付ける場合は、"video stream" フラグも使用する必要があります。 (どちらのフラグも指定しない場合、すべてのオーディオ ストリームとビデオ ストリームが貼り付けられ、元のストリーム番号が保持されます)。
insert データをワークスペースに挿入することを指定します。 挿入ポイントの後のデータは、ワークスペース内で前方に移動してスペースを作成します。 これが既定値です。
overwrite カーソルの後に既存のデータを書き込んで、データをワークスペースにコピーすることを指定します。 "挿入" フラグと "overwrite" フラグは、各フレーム内でのデータの貼り付け方法ではなく、貼り付け操作中にフレームが破棄されるか移動されるかに影響します。
to position データを貼り付けるワークスペース内の位置を指定します。 省略すると、既定で現在位置になります。
ビデオ ストリーム ストリーム コマンドの影響を受けるワークスペース内のビデオ ストリームを指定します。 クリップボードに 1 つのビデオ ストリームのみが存在する場合、ビデオ データは指定されたストリームに貼り付 けられます。 クリップボードに複数のビデオ ストリームが存在する場合、ストリームは ストリーム シーケンスの開始番号を示します。 このフラグを使用し、オーディオも貼り付ける場合は、"オーディオ ストリーム" フラグも使用する必要があります。 (どちらのフラグも指定しない場合、すべてのオーディオ ストリームとビデオ ストリームが貼り付けられ、元のストリーム番号が保持されます)。

lpszFlags

"wait"、"notify"、"test"、またはこれらの組み合わせを指定できます。 これらのフラグの詳細については、「 待機、通知、およびテスト フラグ」を参照してください。

戻り値

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

解説

クリップボードからコピーされたデータにシグナルは存在しません。 変更は、データが明示的に保存された場合にのみ永続的になります。ただし、再生はデータが追加されたかのように機能します。

必要条件

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

関連項目

Mci

MCI コマンド文字列