Edit

Share via

PartyXblManager::FinishProcessingStateChanges

  • Article

Returns an array of Party Xbox Live state changes that were being processed.

Syntax

PartyError FinishProcessingStateChanges(  
    uint32_t stateChangeCount,  
    PartyXblStateChangeArray stateChanges  
)

Parameters

stateChangeCount   uint32_t

The number of changes, provided in the list specified by stateChanges, previously returned by StartProcessingStateChanges() that have now been handled by the title.

stateChanges   PartyXblStateChangeArray
input array of size stateChangeCount

The pointer to the array of changes previously returned by StartProcessingStateChanges() that have now been handled by the title.

Return value

PartyError

c_partyErrorSuccess if the call succeeded or an error code otherwise. The human-readable form of the error code can be retrieved via GetErrorMessage().

Remarks

This method informs the Party Xbox Live Helper library that the state changes reported by a previous call to StartProcessingStateChanges() have now been handled by the title, so their associated resources can be reclaimed. You may call FinishProcessingStateChanges() with any number of state changes. Each state change returned by StartProcessingStateChanges() must be returned to FinishProcessingStateChanges() exactly once, but may be returned out of order and may be interleaved with state changes from other calls to StartProcessingStateChanges(). Even if state changes are held across subsequent calls to StartProcessingStateChanges(), the Party Xbox Live Helper library state returned by all getters will advance and may no longer reflect the same state that the held state changes refer to.

Any resources associated with a specific state change are guaranteed to stay valid until the state change is returned to FinishProcessingStateChanges().

For best results, you should minimize the time you spend handling state changes before calling FinishProcessingStateChanges().

Requirements

Header: PartyXboxLive.h

See also

PartyXblManager
PartyXblStateChange
PartyXblManager::StartProcessingStateChanges