共用方式為


IMDSPDeviceControl::Record 方法 (mswmdm.h)

Record 方法會從目前搜尋位置的裝置外部記錄輸入開始錄製。 必須先呼叫 Seek 方法。

語法

HRESULT Record(
  [in] _WAVEFORMATEX *pFormat
);

參數

[in] pFormat

_WAVEFORMATEX 結構的指標,其中包含必須記錄數據的格式。

傳回值

方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。

傳回碼 描述
S_OK
此方法已成功。
E_BUSY
裝置正在執行作業。
WMDM_E_NOTSUPPORTED
此裝置上未實作記錄函式。
E_FAIL
發生未指定的錯誤。

備註

這個方法可用來叫用兩個裝置錄製 (要儲存在媒體裝置上的音訊播放軌錄製) ,以及從要在電腦上錄製的媒體裝置串流音頻數據。 Seek 方法會決定記錄的發生形式。

某些裝置不支援任一類型的錄製。 開始錄製之前,必須先呼叫 GetCapabilities 方法。 如果嘗試錄製不支援的類型,這個方法會傳回WMDM_E_NOTSUPPORTED。

您可以提供 pFormat 參數的自變數,以指定用於錄製的音訊數據格式。 若要判斷裝置支援的格式,請參閱 IMDSPDevice::GetFormatSupport。 如果 pFormat 參數設定為 NULL,則裝置會以預設格式記錄音訊數據。

當您使用裝置錄製時,您必須列舉儲存媒體內容,以在記錄作業完成之後尋找新的物件。

規格需求

需求
目標平台 Windows
標頭 mswmdm.h
程式庫 Mssachlp.lib

另請參閱

IMDSPDevice::GetFormatSupport

IMDSPDeviceControl 介面

IMDSPDeviceControl::GetCapabilities

IMDSPDeviceControl::Seek

_WAVEFORMATEX