ID3D11DeviceContext::ExecuteCommandList 메서드(d3d11.h)
명령 목록에서 디바이스로 명령을 큐에 대기합니다.
구문
void ExecuteCommandList(
[in] ID3D11CommandList *pCommandList,
BOOL RestoreContextState
);
매개 변수
[in] pCommandList
형식: ID3D11CommandList*
명령 목록을 캡슐화하는 ID3D11CommandList 인터페이스에 대한 포인터입니다.
RestoreContextState
형식: BOOL
명령 목록을 실행한 후 대상 컨텍스트 상태가 저장되고 복원되는지 여부를 결정하는 부울 플래그입니다. TRUE를 사용하여 런타임이 상태를 저장하고 복원해야 함을 나타냅니다. FALSE를 사용하여 상태를 저장하거나 복원하지 않음을 나타내면 명령 목록이 실행된 후 대상 컨텍스트가 기본 상태로 돌아갑니다. 애플리케이션은 TRUE가 전달된 경우 런타임이 복원할 상태와 거의 동일한 상태로 상태를 복원하지 않는 한 일반적으로 FALSE 를 사용해야 합니다. 애플리케이션에서 FALSE를 사용하는 경우 불필요하고 비효율적인 상태 전환을 방지할 수 있습니다.
반환 값
없음
설명
이 메서드를 사용하여 스레드에서 지연된 컨텍스트에 의해 기록된 명령 목록을 재생합니다.
GPU(그래픽 처리 장치)에서 기록된 명령을 실행하려면 지연된 컨텍스트에서 바로 컨텍스트로 명령 목록의 ExecuteCommandList 를 호출해야 합니다. 지연된 컨텍스트에서 다른 지연된 컨텍스트로 명령 목록의 ExecuteCommandList 호출을 사용하여 기록된 목록을 병합할 수 있습니다. 그러나 GPU의 병합된 지연 명령 목록에서 명령을 실행하려면 즉시 컨텍스트에서 명령을 실행해야 합니다.
이 메서드는 쿼리와 관련된 일부 런타임 유효성 검사를 수행합니다. 디바이스 컨텍스트에서 시작된 쿼리는 명령 목록을 실행하여 간접적으로 조작할 수 없습니다(즉, 명령 목록을 생성한 지연된 컨텍스트에 의해 동일한 쿼리에 대해 Begin 또는 End가 호출됨). 이러한 조건이 발생하는 경우 ExecuteCommandList 메서드는 명령 목록을 실행하지 않습니다. 그러나 디바이스 컨텍스트의 상태는 예상대로 계속 유지됩니다(애플리케이션이 디바이스 컨텍스트 상태를 유지하도록 표시하지 않는 한 ID3D11DeviceContext::ClearState 가 수행됨).
Windows Phone 8: 이 API가 지원됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | d3d11.h |
| 라이브러리 | D3d11.lib |