XDspSubmitCommand
지정된 XDSP 스트림에 대해 하드웨어 큐에 하나의 명령을 제출합니다.구문
매개 변수
handle _In_형식: XDspStreamHandle 유효한 XDSP 스트림 핸들입니다. command _In_
형식: XDspCommand* XDspCommand 구조체에 대한 포인터입니다. commandSequence _Out_
형식: uint32_t* 명령 시퀀스 값을 반환하기 위한
uint32_t에 대한 포인터입니다. 자세한 내용은 설명 섹션을 참조하세요.
반환 값
형식: HRESULT 메서드가 성공하면 S_OK를 반환합니다. 메서드가 실패하면 다음 코드를 반환합니다(부분 목록).설명
이 호출은 리소스를 할당하거나 데이터를 처리하지 않고 명령을 하드웨어 서버에 전송만 하므로 빠릅니다. 이 호출은 나중에 명령 결과가 준비된 시기를 추적하기 위해 명령 시퀀스 값 commandSequence를 반환하는uint32_t에 대한 포인터도 받습니다. 이 숫자는 세션 시작 이후 XDspActivate가 호출된 후 성공적으로 제출된 명령의 총 개수를 나타냅니다. 이 숫자는 첫 번째 명령의 경우 1이며 이후 성공적인 XDspSubmitCommand 호출마다 1씩 증가합니다.
하드웨어 서버가 잘못된 상태이면 XDspSubmitCommand는 XDSP_E_DEVICE_FATAL_ERROR 오류 코드를 반환합니다. 이 시점에서는 실패 상태에 있는 XDSP 스트림에 대해 더 이상 명령을 제출할 수 없습니다. 스트림의 XDspStatus도 동일한 오류를 나타냅니다. 영향을 받는 XDSP 스트림은 XDspStatus를 확인하여 제출된 모든 명령이 하드웨어에서 처리되기를 기다려야 하며, 모든 명령이 처리된 후 XDspDeactivate를 사용하여 비활성화해야 합니다. 다른 XDSP 스트림은 영향을 받지 않으며 하드웨어는 계속해서 명령을 처리합니다.
요구 사항
헤더: XDspAudio.h 라이브러리: Chad.lib 지원 플랫폼: XBOX Series X|S개념 설명서
관련 항목
XDSPXDspSubmitCommandWithEnvelope
XDSP 오류
XDSP API를 사용한 단일 스트림 컨볼루션 개요
XDSP API를 사용한 단일 스트림 FFT/IFFT 개요
XDSP API를 사용한 엔벨로프 포함 단일 스트림 컨볼루션 개요