(spatialaudioclient.h) 的 ISpatialAudioObjectBase：：GetBuffer 方法

取得緩衝區，用來提供 ISpatialAudioObject 的音訊數據。

語法

HRESULT GetBuffer(
  [out] BYTE   **buffer,
  [out] UINT32 *bufferLength
);

[out] buffer

將音訊數據寫入其中的緩衝區。

[out] bufferLength

如果方法成功，它會傳回 S_OK。如果失敗，可能的傳回碼包括但不限於下表所示的值。

傳回碼	Description
SPTLAUDCLNT_E_OUT_OF_ORDER	呼叫 GetBuffer 之前未呼叫 ISpatialAudioObjectRenderStream：：BeginUpdatingAudioObjects。第一次呼叫 GetBuffer 之前，以及每次呼叫 ISpatialAudioObjectRenderStream：：EndUpdatingAudioObjects 之後，都必須呼叫這個方法。
SPTLAUDCLNT_E_RESOURCES_INVALIDATED	SetEndOfStream 在先前的音訊處理階段中明確或隱含地呼叫。如果未在音訊 (處理內呼叫 GetBuffer，則會隱含地由系統呼叫 SetEndOfStream：：BeginUpdatingAudioObjectRenderStream：：BeginUpdatingAudioObjects 和 ISpatialAudioObjectRenderStream：：EndUpdatingAudioObjects) 。

第一次呼叫 ISpatialAudioObject 之後呼叫 GetBuffer 時，會呼叫 ISpatialAudioObjectRenderStream：：ActivateSpatialAudioObject，
空間音訊物件的存留期開始。
若要讓空間音頻物件保持運作，必須在每次處理階段上呼叫此 GetBuffer (ISpatialAudioObjectRenderStream：：BeginUpdatingAudioObjects 和 ISpatialAudioObjectRenderStream：：EndUpdatingAudioObjects) 。如果未在音訊處理階段內呼叫 GetBuffer ，則會在音訊物件上隱含呼叫 SetEndOfStream 來停用，而且音訊物件只能在呼叫 Object 上的 Release 之後重複使用，然後再次呼叫 ActivateSpatialAudioObject 來重新啟用物件。