共用方式為


IWMDMDeviceControl::Record 方法 (mswmdm.h)

Record 方法會從目前搜尋位置的裝置外部記錄輸入開始錄製。 必須先呼叫 IWMDMDeviceControl::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 參數提供自變數,以指定錄製的音訊格式。 若要判斷裝置支援的格式,請參閱 GetFormatSupport。 如果 pFormat 參數設定為 NULL,裝置會以預設格式記錄音訊數據。

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

規格需求

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

另請參閱

IWMDMDevice::GetFormatSupport

IWMDMDeviceControl 介面

IWMDMDeviceControl::GetCapabilities

IWMDMDeviceControl::Seek

IWMDMObjectInfo 介面

_WAVEFORMATEX