IAcpHal::Connect
ACP에 연결합니다.구문
매개 변수
numCommands형식: UINT32 ACP 명령 큐에 할당할 명령의 수를 지정합니다. 이 값은 0보다 커야 하며 각 2.67ms 오디오 프레임에 대해 발행된 명령 수를 처리할 수 있을 만큼 커야 합니다. numMessages
형식: UINT32 ACP 메시지 큐에 할당할 메시지의 수를 지정합니다. 타이틀이 수신한 메시지를 처리하지 않는 경우 이 값은 0일 수 있습니다. command completed 메시지(ACP_MESSAGE_TYPE 참조)에 대해 등록한 경우, 명령 수만큼의 메시지가 있게 됩니다. 일반적으로 이 메시지 큐는 오디오 프레임당 한 번보다 덜 자주 처리되므로, 여러 프레임 분량의 메시지를 계획하세요.
반환 값
형식: HRESULT 메서드가 성공하면S_OK를 반환합니다. 메서드가 실패하면 다음 코드 중 하나를 반환합니다(부분 목록):
설명
이 인터페이스의 다른 메서드를 호출하기 전에 이 메서드를 호출하세요. 그러나 Disconnect를 호출한 후에는 이 메서드를 다시 호출할 수 있습니다. SubmitCommand도 참조하세요. 메서드가E_INVALIDARG 또는 ACP_E_ALREADY_CONNECTED 이외의 오류로 실패하면, 모든 기존 ACP 클라이언트 객체를 파괴하고 할당된 SHAPE 컨텍스트를 AcpHalReleaseShapeContexts를 사용하여 해제할 것을 권장합니다. 새로운 SHAPE 컨텍스트와 ACP 클라이언트 객체는 각각 AcpHalAllocateShapeContexts 및 AcpHalCreate를 사용하여 필요에 따라 다시 할당/생성해야 합니다.
요구 사항
헤더: acphal.h 지원 플랫폼: XBOX One 제품군 콘솔 및 XBOX Series 콘솔관련 항목
DisconnectAcpHal