IAudioProcessingObject::Initialize 方法 (audioenginebaseapo.h)

Initialize 方法初始化 APO 并支持长度可变的数据。

语法

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

参数

[in] cbDataSize

这是初始化数据的大小(以字节为单位)。

[in] pbyData

这是特定于此 APO 的初始化数据。

返回值

如果调用成功,该方法 Initialize 将返回值 S_OK。 否则,此方法返回以下错误代码之一:

返回代码 说明
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 操作系统。
目标平台 通用
标头 audioenginebaseapo.h
Library Audioenginebaseapo.idl
IRQL 任何级别

另请参阅

APOInitBaseStruct