Skip to main content

​
XApuEnqueueCommand

XAPU 명령 큐에 단일 명령을 제출합니다.

​
Syntax

​
Parameters

handle   _In_
Type: XApuHandle XApuConnect를 호출하여 반환된 핸들입니다. command   _In_
Type: XApuCommandId* XAPU 입력 큐에 제출할 명령입니다. totalCommandCount   _Out_opt_
Type: uint32_t* 반환되는 총 명령 수입니다.

​
Return value

Type: HRESULT 성공 시 S_OK를 반환하고, 그렇지 않으면 오류 코드를 반환합니다.

​
Remarks

이 호출은 리소스를 할당하거나 데이터를 처리하지 않고 단순히 하드웨어 서버로 명령을 보내기 때문에 빠릅니다. XApuConnectInputParameters::maxQueuedCommandsPerStream 개의 명령이 처리 중인 경우 이 호출은 XAPU_E_QUEUE_FULL을 반환합니다. 이 오류를 방지하려면 호출자는 XApuDequeueResult를 통해 하나 이상의 결과를 검색해야 합니다. 이 호출은 스레드 안전하며, 즉 여러 스레드에서 명령을 제출할 수 있지만 두 개 이상의 스레드에서 호출해도 성능상의 이점은 없습니다. 이 호출은 또한 현재 세션에 대한 totalCommandCount를 반환하기 위해 uint32_t에 대한 포인터를 받습니다. 이 숫자는 세션이 시작되고 XApuConnect가 호출된 이후 성공적으로 제출된 총 명령 수를 나타냅니다. 이 숫자는 0으로 돌아가지 않습니다. 하드웨어 서버가 잘못된 상태인 경우 XApuEnqueueCommand는 XAPU_E_DEVICE_FATAL_ERROR 오류 코드를 반환합니다. 이 경우 모든 XAPU 클라이언트의 연결을 끊고 다시 연결해야 합니다. 이 메서드가 실패하면 자세한 오류 코드가 반환됩니다. 다음 표는 각 XApuCommandType을 XApuEnqueueCommand에 전달해야 하는 구조체 유형에 매핑합니다.

​
Requirements

Header: xapu.h Library: xapu.lib Supported platforms: XBOX Series X|S

​
See also

XAPU
마지막 수정일 2026년 8월 24일

관련 항목

XApuCommandTypeXApuDecodeConvertCommandXApuDecodeConvertActivateCommandXApuConnectXApuDequeueResult