delete コマンド
delete コマンドは、ファイルからデータ セグメントを削除します。 デジタル ビデオおよび波形オーディオ デバイスは、このコマンドを認識します。
このコマンドを送信するには、lpszCommand パラメーターを次のように設定して mciSendString 関数を呼び出します。
_stprintf_s(
lpszCommand,
TEXT("delete %s %s %s"),
lpszDeviceID,
lpszPosition,
lpszFlags
);
パラメーター
-
lpszDeviceID
-
MCI デバイスの識別子。 この識別子またはエイリアスは、デバイスを開いたときに割り当てられます。
-
lpszPosition
-
削除するデータ セグメントを識別するフラグ。 次の表に、 delete コマンドを認識するデバイスの種類と、各種類で使用されるフラグを示します。
値 説明 説明 digitalvideo - 四角形
- オーディオ ストリーム ストリーム
- from position
- to position
- ビデオ ストリーム ストリーム
waveaudio from position to position 次の表に、 lpszPosition パラメーターで指定できるフラグとその意味を示します。
値 説明 四角形 削除された各フレームの部分を指定します。 省略すると、既定値はフレーム全体になります。 この項目を指定した場合、フレームは削除されません。 代わりに、四角形内の領域は黒になります。 オーディオ ストリーム ストリーム コマンドの影響を受けるワークスペース内のオーディオ ストリームを指定します。 このフラグを使用し、ビデオも削除する場合は、"video stream" フラグも使用する必要があります。 (どちらのフラグも指定しない場合は、すべてのオーディオ ストリームとビデオ ストリームが削除されます)。 from position 削除を開始する位置を指定します。 このフラグを省略すると、削除は現在の位置から開始されます。 to position 削除が終了する位置を指定します。 このフラグを省略すると、削除はコンテンツまたはワークスペースの末尾まで続きます。 ビデオ ストリーム ストリーム コマンドの影響を受けるワークスペース内のビデオ ストリームを指定します。 このフラグを使用し、オーディオも削除する場合は、"オーディオ ストリーム" フラグも使用する必要があります。 (どちらのフラグも指定しない場合は、すべてのオーディオ ストリームとビデオ ストリームが削除されます)。 -
lpszFlags
-
"wait"、"notify"、またはその両方を指定できます。 デジタル ビデオおよび VCR デバイスの場合は、"テスト" を指定することもできます。 これらのフラグの詳細については、「 待機、通知、およびテスト フラグ」を参照してください。
戻り値
成功した場合は 0 を返し、それ以外の場合はエラーを返します。
解説
位置値を使用するコマンドを発行する前に、set コマンドを使用して目的の時刻形式を 設定 する必要があります。
例
次のコマンドは、波形オーディオ データを 1 ミリ秒から 900 ミリ秒 (時間形式がミリ秒に設定されている場合) から削除します。
delete mysound from 1 to 900
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows 2000 Server [デスクトップ アプリのみ] |