IAudioProcessingObject::Initialize 方法 (audioenginebaseapo.h)

Initialize 方法會初始化 APO,並支援可變長度的數據。

語法

HRESULT Initialize(
  [in] UINT32 cbDataSize,
  [in] BYTE   *pbyData
);

參數

[in] cbDataSize

這是初始化數據的大小,以位元組為單位。

[in] pbyData

這是此 APO 特有的初始化數據。

傳回值

如果呼叫成功,此方法 Initialize 會傳回S_OK值。 否則,這個方法會傳回下列其中一個錯誤碼:

傳回碼 Description
E_POINTER
傳遞至函式的指標無效。
E_INVALIDARG
無效引數。
APOERR_ALREADY_INITIALIZED
APO 已經初始化。
其他 HRESULTS
音訊引擎會追蹤這些額外的錯誤狀況。

備註

如果此方法用來初始化 APO,而不需要初始化任何數據,就可以接受將 NULL 當做 pbyData 參數的值,而 0 (零) 做為 cbDataSize 參數的值。 提供的數據長度為可變長度,且必須具有下列格式:

Struct MyAPOInitializationData
{
APOInitBaseStruct APOInit;
// list additional struct members here
// ...
};

規格需求

需求
最低支援的用戶端 適用於 Windows Vista 和更新版本的 Windows 作業系統。
目標平台 Universal
標頭 audioenginebaseapo.h
程式庫 Audioenginebaseapo.idl
IRQL 任何層級

另請參閱

APOInitBaseStruct