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