RegisterLampArrayStatusCallback
LampArray 상태가 변경될 때마다 호출되는 콜백 함수를 등록합니다.구문
매개변수
callbackFunc _In_ 형식: LampArrayStatusCallback 등록할 호출자 정의 함수입니다. LampArray 상태가 변경될 때 호출됩니다. enumerationKind형식: LampArrayEnumerationKind LampArrayStatusCallback 함수에 대해 원하는 장치 열거 동작을 지정합니다. context _In_opt_
형식: void* 콜백 함수에 관련된 정보를 포함하는 개체에 대한 포인터입니다. 일반적으로 이는 호출 개체입니다. callbackToken _Out_ _Result_zeroonfailure_ 형식: LampArrayCallbackToken* 나중에 콜백 함수 등록을 해제하는 데 사용할 수 있는 토큰 값입니다.
반환값
형식: HRESULT 함수 결과입니다.설명
LampArrayEnumerationKind 매개변수를 통해 호출자는 이 호출 시점에 연결된 LampArray 장치에 대한 콜백을 어떻게 수신할지 지정할 수 있습니다. LampArrayEnumerationKind::Blocking이 선택된 경우 RegisterLampArrayStatusCallback 함수는 연결된 각 장치에 대해 콜백이 호출될 때까지 블록됩니다. 즉, 콜백은 호출 스레드에서 실행됩니다. 첫 번째 콜백이 등록되면 LampArray API는 ILampArray 장치 상태 알림을 처리하기 위한 워커 스레드를 시작합니다. 이러한 이벤트는 자주 발생하지 않으며, 그 외에는 워커 스레드가 대기 상태로 유지됩니다. 등록 호출이 반환된 이후에는 모든 후속 LampArrayStatusCallbacks가 이 워커 스레드에서 순차적으로 호출됩니다. LampArrayEnumerationKind::Async가 지정되면, 이 호출은 즉시 반환되며, 호출 시점에 연결되어 있는 LampArrays는 앞서 언급한 LampArray 콜백 워커 스레드에서 열거됩니다. 다음 코드는 LampArrayStatusCallback 함수를 등록하고 등록 해제하는 예제입니다.요구 사항
헤더: LampArray.h 라이브러리: xgameplatform.lib 지원되는 플랫폼: XBOX One 계열 콘솔 및 XBOX Series 콘솔함께 보기
Lighting API 개요Lighting 기본 사항
LampArrayStatusCallback
UnregisterLampArrayCallback
LampArrayEnumerationKind
