Skip to main content
번들을 실행합니다.

구문

매개 변수

pCommandList [in]
형식: ID3D12GraphicsCommandList *
실행할 번들을 결정하는 ID3D12GraphicsCommandList를 지정합니다.

반환 값

형식: void 없음.

설명

번들은 파이프라인 상태 개체 및 기본 도형 토폴로지를 제외하고 ExecuteBundle이 호출되는 상위 명령 목록에서 모든 상태를 상속합니다. 번들에 설정된 모든 상태는 상위 명령 목록의 상태에 영향을 줍니다. ExecuteBundle은 예측 연산이 아님에 유의하세요.

런타임 유효성 검사

런타임은 “callee”가 번들이고 “caller”가 직접 명령 목록임을 확인합니다. 런타임은 또한 번들이 닫혀 있는지 확인합니다. 계약이 위반되면 런타임은 호출을 자동으로 삭제합니다. 유효성 검사에 실패하면 Close가 E_INVALIDARG를 반환합니다.

디버그 레이어

디버그 레이어는 런타임이 실패하는 것과 동일한 경우에 경고를 발생시킵니다. ExecuteCommandList가 호출될 때 조건자가 설정된 경우 디버그 레이어는 경고를 발생시킵니다. 또한 명령 목록에 의해 참조되는 리소스가 삭제된 것을 감지하면 디버그 레이어는 오류를 발생시킵니다.
디버그 레이어는 또한 명령 목록에서 Close가 호출된 이후 번들과 관련된 명령 할당자가 재설정되지 않았는지 확인합니다. 이 유효성 검사는 ExecuteBundle 시점과 상위 명령 목록이 명령 큐에서 실행될 때 발생합니다.

예제

D3D12Bundles 샘플은 다음과 같이 ID3D12GraphicsCommandList::ExecuteBundle을 사용합니다:
D3D12 참조의 예제 코드를 참조하세요.

요구 사항

헤더: d3d12_xs.h 또는 d3d12_x.h
라이브러리: d3d12_xs.lib 또는 d3d12_x.lib
지원 플랫폼: XBOX Series 콘솔 및 XBOX One 제품군

함께 보기

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