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 | 任何级别 |