XApuDisconnect
하드웨어 서버와의 연결을 끊고 XApuConnect 중에 할당된 모든 리소스를 해제합니다.Syntax
Parameters
handle _In_Type: XApuHandle XApuConnect를 호출하여 반환된 핸들입니다.
Return value
Type: HRESULT 성공 시S_OK를 반환하고, 그렇지 않으면 오류 코드를 반환합니다.
Remarks
하드웨어 서버와의 연결을 끊는 것 외에도, 이 호출은 XApuConnectOutputParameters::baseData를 해제하고 XApuConnectOutputParameters::resultReadyEvent 핸들을 닫습니다. 큐에 있는 모든 명령이 처리되기 전에 XApuDisconnect가 호출되면 모든 리소스를 해제하고 이 오류 코드 XAPU_E_PENDING_RESULTS를 반환합니다. 호출자는 XApuDisconnect를 호출하기 전에 큐에 있는 마지막 명령의 결과를 기다려야 합니다. 그렇지 않으면 하드웨어에서 심각한 오류가 발생하여 다른 활성 XAPU 클라이언트가 비활성화될 수 있습니다. 스트림을 시작하고 중지하기 위해 XapuConnect 및 XApuDisconnect를 자주 호출하는 것은 권장되지 않습니다. 이러한 호출은 시간이 많이 걸리고 메모리 단편화로 인한 리소스 손실을 초래할 수도 있기 때문입니다. 대신 스트리밍 세션 초기화 시 XapuConnect를 한 번 호출한 다음, 스트리밍 중에 스트림을 시작하고 중지하기 위해 XApuCommandType::Activate 및 XApuCommandType::Deactivate를 사용해야 합니다. 스트리밍 세션이 끝나면 XApuDisconnect를 호출해야 합니다. 이는 모든 XAPU 클라이언트에 적용됩니다.Requirements
Header: xapu.h Library: xapu.lib Supported platforms: XBOX Series X|SConceptual documentation
See also
XApuConnectXAPU