IXAPO::LockForProcess メソッド (xapo.h)

XAudio2 によって呼び出され、XAPO の入力構成と出力構成がロックされ、 プロセスがリアルタイム スレッドで呼び出される前に最終的な初期化を実行できます。

構文

HRESULT LockForProcess(
  UINT32                               InputLockedParameterCount,
  const XAPO_LOCKFORPROCESS_PARAMETERS *pInputLockedParameters,
  UINT32                               OutputLockedParameterCount,
  const XAPO_LOCKFORPROCESS_PARAMETERS *pOutputLockedParameters
);

パラメーター

InputLockedParameterCount

ppInputLockedParameters 内の要素の数。 XAPO_REGISTRATION_PROPERTIES内にある必要があります。MinInputBufferCount と XAPO_REGISTRATION_PROPERTIES。CXAPOBase::CXAPOBase に渡される MaxInputBufferCount 値。

pInputLockedParameters

入力 XAPO_LOCKFORPROCESS_BUFFER_PARAMETERS 構造体の配列。 InputLockedParameterCount が 0 の場合、pInputLockedParameters は NULL になる可能性があります。それ以外の場合は、InputLockedParameterCount 要素が必要です。

OutputLockedParameterCount

ppOutputLockedParameters 内の要素の数。 XAPO_REGISTRATION_PROPERTIES内にある必要があります。MinOutputBufferCount と XAPO_REGISTRATION_PROPERTIES。CXAPOBase::CXAPOBase に渡される MaxOutputBufferCount 値。 XAPO_FLAG_BUFFERCOUNT_MUST_MATCH フラグが XAPO_REGISTRATION_PROPERTIES で指定された場合。次 に、OutputLockedParameterCount がInputLockedParameterCount と等しい必要があります。

pOutputLockedParameters

出力 XAPO_LOCKFORPROCESS_BUFFER_PARAMETERS 構造体の配列。 OutputLockedParameterCount が 0 の場合、pOutputLockedParameters は NULL になる可能性があります。それ以外の場合は、OutputLockedParameterCount 要素が必要です。

戻り値

成功した場合はS_OKを返し、それ以外の場合はエラー コードを返します。

解説

ロックされると、入力と出力の構成とその他のロックされたパラメーターは、 UnLockForProcess が呼び出されるまで一定のままになります。 XAPO がロックされると、UnLockForProcess 関数が呼び出されるまで、LockForProcess のそれ以降の呼び出しは有効になりません。

XAPO は、 IsInputFormatSupported メソッドと IsOutputFormatSupported メソッドの実装によってサポート される 特定の形式を示します。 XAPO は、入力構成と出力構成がサポートされており、必要な効果固有の初期化が完了していることをアサートする必要があります。 IsInputFormatSupported、IsOutputFormatSupported、および Initialize メソッドは、このメソッドを呼び出す前に必要に応じて使用する必要があります。

Process は非ブロッキング メソッドであるため、Process に必要なすべての内部メモリ バッファーを LockForProcess に割り当てる必要があります。

LockForProcessが正常に返される前にプロセスが呼び出されることはありません。

LockForProcess は XAudio2 によって直接呼び出され、クライアント コードでは呼び出さないでください。

プラットフォームの要件

Windows 10 (XAudio2.9);Windows 8、Windows Phone 8 (XAudio 2.8);DirectX SDK (XAudio 2.7)

要件

対象プラットフォーム	Windows
ヘッダー	xapo.h

関連項目

IXAPO