MCI_DELETE コマンド
MCI_DELETE コマンドは、ファイルからデータを削除します。 デジタル ビデオおよび波形オーディオ デバイスは、このコマンドを認識します。
このコマンドを送信するには、次のパラメーターを指定して mciSendCommand 関数を呼び出します。
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_DELETE,
DWORD dwFlags,
(DWORD) (LPMCI_GENERIC_PARMS) lpDelete
);
パラメーター
-
wDeviceID
-
コマンド メッセージを受信する MCI デバイスのデバイス識別子。
-
dwFlags
-
MCI_NOTIFY、MCI_WAIT、またはデジタル ビデオ デバイスの場合は、MCI_TEST。 これらのフラグの詳細については、「 待機、通知、およびテスト フラグ」を参照してください。
-
lpDelete
-
MCI_GENERIC_PARMS構造体へのポインター。 (拡張コマンド セットを持つデバイスは、この構造体をデバイス固有の構造に置き換える場合があります)。
戻り値
成功した場合は 0 を返し、それ以外の場合はエラーを返します。
解説
digitalvideo デバイスの種類には、次のフラグが適用されます。
-
MCI_DGV_DELETE_AT
-
lpDelete によって識別される構造体の rc メンバーに四角形が含まれます。 四角形は、削除する各フレームの部分を指定します。 このフラグを使用すると、フレームはワークスペースに保持され、四角形で指定された領域は黒になります。 フラグを省略すると、MCI_DELETEは既定でフレーム全体に設定され、ワークスペースからフレームが削除されます。
-
MCI_DGV_DELETE_AUDIO_STREAM
-
オーディオ ストリーム番号は、lpDelete によって識別される構造体の dwAudioStream メンバーに含まれます。 このフラグを使用し、ビデオも削除する場合は、MCI_DGV_DELETE_VIDEO_STREAM フラグも使用する必要があります。 (どちらのフラグも指定しない場合は、すべてのオーディオ ストリームとビデオ ストリームのデータが削除されます)。
-
MCI_DGV_DELETE_VIDEO_STREAM
-
lpDelete によって識別される構造体の dwVideoStream メンバーには、ビデオ ストリーム番号が含まれています。 このフラグを使用し、オーディオも削除する場合は、MCI_DGV_DELETE_AUDIO_STREAM フラグも使用する必要があります。 (どちらのフラグも指定しない場合は、すべてのオーディオ ストリームとビデオ ストリームのデータが削除されます)。
-
MCI_FROM
-
開始位置は、lpDelete によって識別される構造体の dwFrom メンバーに含まれます。 位置の値に割り当てられる単位は、 MCI_SET コマンドのMCI_SET_TIME_FORMAT フラグで指定されます。
-
MCI_TO
-
終了位置は、lpDelete によって識別される構造体の dwTo メンバーに含まれます。 位置の値に割り当てられた単位は、MCI_SETのMCI_SET_TIME_FORMAT フラグで指定されます。
デジタル ビデオ デバイスの場合、 lpDelete パラメーターは MCI_DGV_DELETE_PARMS 構造体を指します。
waveaudio デバイスの種類には、次のフラグが適用されます。
-
MCI_FROM
-
開始位置は、lpDelete によって識別される構造体の dwFrom メンバーに含まれます。 位置の値に割り当てられる単位は、MCI_SETのMCI_SET_TIME_FORMAT フラグで指定されます。
-
MCI_TO
-
終了位置は、lpDelete によって識別される構造体の dwTo メンバーに含まれます。 位置の値に割り当てられた単位は、MCI_SETのMCI_SET_TIME_FORMAT フラグで指定されます。
波形オーディオ デバイスの場合、 lpDelete パラメーターは MCI_WAVE_DELETE_PARMS 構造体を指します。
必要条件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows 2000 Server [デスクトップ アプリのみ] |
| ヘッダー |
|