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