XNetworkingUnregisterConnectivityHintChanged

XNetworkingRegisterConnectivityHintChanged로 등록된 콜백 함수를 등록 해제합니다.

구문

bool XNetworkingUnregisterConnectivityHintChanged(
         XTaskQueueRegistrationToken token,
         bool wait
)

wait _In_
형식: bool

보류 중인 콜백이 완료될 때까지 차단할지 여부를 나타냅니다.

형식: bool

wait가 false이고 등록 해제 호출이 보류 중이면 false를 반환합니다. 그렇지 않으면 true를 반환합니다.

참고 항목

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

이 함수는 다음의 작업을 수행합니다.

등록된 콜백 집합에서 토큰으로 연결된 콜백이 제거됩니다.
해당 콜백 토큰에 대해 콜백이 실행되고 있지 않으면 호출 시 true를 반환합니다.
콜백이 실행 중이며 wait가 true이면, 실행 중인 콜백이 완료될 때까지 호출이 차단됩니다.
콜백이 실행 중이며 wait가 false이면, 호출은 차단되지 않고 false를 반환합니다. 토큰에 대한 콜백이 완료되면 토큰이 자동으로 등록 해제됩니다.

참고 항목

wait가 true이면 교착 상태가 되기 때문에 XNetworkingConnectivityHintChangedCallback 내에서 이 함수를 호출해서는 안 됩니다.

이 메커니즘은 다음과 같은 코딩 패턴을 허용합니다.

등록 해제 호출 후 콜백이 결코 호출되지 않도록 보장하기 위해 등록 해제를 차단할 수 있습니다.
차단하지 않도록 선택할 수 있습니다. 데이터를 삭제하기 전 콜백이 완료되도록 해야 할 경우, wait에 대해 false를 사용하여 등록 해제를 주기적으로 호출할 수 있습니다. 최종적으로 true가 반환되면 모든 콜백이 완료되고, 상태를 삭제할 수 있습니다.
등록 해제 호출 중 콜백이 호출되는지 여부가 중요하지 않으면, wait에 대해 false를 전달하고 반환 값을 무시할 수 있습니다.

헤더: XNetworking.h

라이브러리: xgameruntime.lib

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

이 페이지가 도움이 되었나요?