IDiscMaster：：EnumDiscRecorders 方法 (imapi.h)

擷取使用中磁片主機板格式所支援之所有光碟錄製器的列舉值。

語法

HRESULT EnumDiscRecorders(
  [out] IEnumDiscRecorders **ppEnum
);

參數

[out] ppEnum

IEnumDiscRecorders列舉值的指標位址。

傳回值

成功時會傳回S_OK，但可能會因為實作而傳回其他成功碼。 下列錯誤碼通常會在作業失敗時傳回，但不代表唯一可能的錯誤值：

備註

IEnumDiscRecorders 是標準 COM 列舉值，如 IEnumXXXX中所述。 每次呼叫 Next 都會傳回 IDiscRecorder的指標陣列。 每個錄製器介面都代表已經與基礎實體磁片錄製器相關聯的單一可用錄製器。

可用的錄製器清單可能會因為隨插即用抵達或離開而變更，或呼叫 SetActiveDiscMasterFormat。 當應用程式收到 IDiscMasterProgressEvents：：NotifyPnPActivity的呼叫時，就會收到這些變更的通知。 發生變更時，應用程式應該再次呼叫此方法以擷取新的列舉值，因為每個列舉值都包含列舉時支援的裝置快照集。

移除裝置時，即使缺少基礎實體裝置，其指標和 IDiscRecorder 介面仍必須保持有效狀態。 在此情況下， IDiscRecorder 或記錄磁片的要求可能會傳回IMAPI_E_DEVICE_NOTPRESENT。

呼叫此方法時， 會更新 MaxWriteSpeed 屬性。 預設設定是最高可用的寫入速度。

需求

另請參閱

IDiscMaster