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 [僅限桌面應用程式] |
標頭 |
|