XGameStreamingUnregisterClientPropertiesChanged

이전에 등록된 XGameStreamingClientPropertiesChangedCallback을 등록 해제합니다.

구문

bool XGameStreamingUnregisterClientPropertiesChanged(
         XGameStreamingClientId client,
         XTaskQueueRegistrationToken token,
         bool wait
)

매개 변수

client _In_
형식: XGameStreamingClientId

속성 변경 알림을 구독 취소할 스트리밍 클라이언트입니다. 이 ID는 일반적으로 XGameStreamingConnectionStateChangedCallback에 대한 매개 변수로 가져옵니다.

token _In\
형식: XTaskQueueRegistrationToken

더 이상 발생하지 않는 콜백에 대해 XGameStreamingRegisterClientPropertiesChanged에서 제공한 등록 토큰

wait _In_
형식: bool

wait이(가) true로 설정된 경우 XGameStreamingUnregisterClientPropertiesChanged은(는) 등록이 취소되고 처리 중인 콜백이 완료될 때까지 반환되지 않습니다.

wait이(가) false로 설정된 경우 XGameStreamingUnregisterClientPropertiesChanged은(는) 등록이 해지되는 즉시 반환됩니다. 새 콜백이 전달되지 않지만 함수가 반환될 때 진행 중인 콜백이 계속 실행될 수 있습니다.

반환 값

형식: bool

등록 취소에 성공하면 true를 반환하고, 성공하지 못한 경우 false를 반환합니다.

설명

참고 항목

이 함수는 시간에 민감한 스레드에서 호출하는 것이 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.

이 API를 사용하면 스트림 물리적 차원과 같은 XGameStreamingClientProperty가 변경될 때마다 게임에서 XGameStreamingClientPropertiesChangedCallback 수신을 중단할 수 있습니다.

예

    // On client disconnection remove from list of client and do per client cleanup
    void OnClientDisconnected(XGameStreamingClientId client)
    {
        StreamingClient connectedClient;
        GetConnectedClient(client, &connectedClient);

        // unregister the client property changed handler
        XGameStreamingUnregisterClientPropertiesChanged(client, connectedClient.propertyChangeToken, true);
        std::erase(std::remove(m_streamingClients.begin(), m_streamingClients.end(), connectedClient), m_streamingClients.end());
    }

요구 사항

헤더: xgamestreaming.h

라이브러리: xgameruntime.lib

지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔

참고 항목

XGameStreamingClientPropertyXGameStreamingClientPropertiesChangedCallbackXGameStreamingRegisterClientPropertiesChangedXGameStreaming