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結構的指標。 (具有擴充命令集的裝置可能會將此結構取代為裝置特定的結構。)

傳回值

如果成功或發生錯誤,則傳回零。

備註

下列旗標適用于 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 [僅限桌面應用程式]
標頭
Mmsystem.h (包含 Windows.h)

另請參閱

Mci

MCI 命令