Initialize 方法初始化 APO 并支持长度可变的数据。
语法
HRESULT Initialize(
  [in] UINT32 cbDataSize,
  [in] BYTE   *pbyData
);
参数
[in] cbDataSize
这是初始化数据的大小(以字节为单位)。
[in] pbyData
这是特定于此 APO 的初始化数据。
返回值
如果调用成功,该方法 Initialize 将返回值 S_OK。 否则,此方法返回以下错误代码之一:
| 返回代码 | 说明 | 
|---|---|
| 
 | 传递给函数的指针无效。 | 
| 
 | 无效的参数。 | 
| 
 | APO 已初始化。 | 
| 
 | 音频引擎跟踪这些附加错误条件。 | 
注解
如果使用此方法初始化 APO 而无需初始化任何数据,则可以接受提供 NULL 作为 pbyData 参数的值,提供 0 (零) 作为 cbDataSize 参数的值。 提供的数据长度可变,必须具有以下格式:
Struct MyAPOInitializationData
{
APOInitBaseStruct APOInit;
// list additional struct members here
// ...
};
要求
| 要求 | 值 | 
|---|---|
| 最低受支持的客户端 | 适用于 Windows Vista 和更高版本的 Windows 操作系统。 | 
| 目标平台 | 通用 | 
| 标头 | audioenginebaseapo.h | 
| Library | Audioenginebaseapo.idl | 
| IRQL | 任何级别 |