MCI_RESERVE命令

MCI_RESERVE命令會為設備磁碟機實例的工作區配置連續磁碟空間，以便用於後續錄製。 數位視訊裝置可辨識此命令。

若要傳送此命令，請使用下列參數呼叫 mciSendCommand 函式。

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_RESERVE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_DGV_RESERVE_PARMS) lpReserve
);

參數

wDeviceID

要接收命令訊息之 MCI 裝置的裝置識別碼。

dwFlags

MCI_NOTIFY、MCI_WAIT或MCI_TEST。 如需這些旗標的相關資訊，請參閱 Wait、Notify 和 Test Flags。

lpReserve

MCI_DGV_RESERVE_PARMS結構的指標。

傳回值

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

備註

如果工作區包含未儲存的資料，就會遺失此資料。 如果在錄製之前未保留磁碟空間， MCI_RECORD 命令會執行具有裝置特定預設參數的隱含保留。 在某些實作上，不需要保留，而且裝置驅動程式可能會忽略。 明確保留空間可讓您更充分地控制磁片配置延遲的時間、配置的空間數量，以及配置磁碟空間的位置。 您可以再次發出MCI_RESERVE來變更已保留給此裝置實例的磁碟空間數量和位置。 在儲存任何記錄的資料或裝置驅動程式實例關閉之前，不會解除配置任何已配置且仍然未使用的磁碟空間。

如果使用 MCI_SETVIDEO 命令的MCI_OFF旗標關閉視訊，則保留的空間不包含任何視訊。 如果使用 MCI_SETAUDIO 命令的 MCI_OFF 旗標關閉音訊，則保留的空間不包含任何音訊。 如果音訊和視訊都關閉，或要求的大小為零，則不會保留任何空間，而且會解除配置任何現有的保留空間。

下列其他旗標適用于數位視訊裝置：

MCI_DGV_RESERVE_IN

lpReserve所識別之結構的lpstrPath成員包含緩衝區的位址，其中包含暫存檔的位置。 緩衝區只包含用來保存記錄資料之檔案的磁片磁碟機和目錄路徑;檔案名是由設備磁碟機所指定。 除非明確儲存裝置實例，否則會在裝置實例關閉時刪除此暫存檔。 如果省略此旗標，設備磁碟機會指定配置磁碟空間的位置。

MCI_DGV_RESERVE_SIZE

lpReserve所識別結構的dwSize成員會指定要在工作區中保留的大約磁碟空間量以供錄製。 此值是以目前的時間格式指定。 磁碟空間量是從要求的時間估計，以及檔案格式和視訊和音訊演算法和品質值生效的來源。 如果省略此旗標，設備磁碟機可能會使用它定義的預設值。

規格需求

另請參閱

Mci

MCI 命令