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 は既に初期化されています。
その他の HRESULT	これらの追加のエラー条件は、オーディオエンジンによって追跡されます。

このメソッドを使用してデータを初期化せずに APO を初期化する場合は、pbyData パラメーターの値として NULL を指定し、cbDataSize パラメーターの値として 0 (ゼロ) を指定できます。指定されるデータは可変長であり、次の形式である必要があります。

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

要件	値
サポートされている最小のクライアント	Windows Vista 以降の Windows オペレーティングシステムで使用できます。
対象プラットフォーム	ユニバーサル
Header	audioenginebaseapo.h
Library	Audioenginebaseapo.idl
IRQL	任意のレベル