Skip to main content
Ejecuta un lote.

Sintaxis

Parámetros

pCommandList [in]
Tipo: ID3D12GraphicsCommandList *
Especifica el ID3D12GraphicsCommandList que determina el lote que se va a ejecutar.

Valor devuelto

Tipo: void Ninguno.

Comentarios

Los lotes heredan todo el estado de la lista de comandos primaria en la que se llama a ExecuteBundle, excepto el objeto de estado de canalización y la topología de primitivas. Todo el estado que se establece en un lote afectará al estado de la lista de comandos primaria. Tenga en cuenta que ExecuteBundle no es una operación con predicados.

Validación en tiempo de ejecución

El runtime validará que el “destinatario de la llamada” sea un lote y que el “autor de la llamada” sea una lista de comandos directa. El runtime también validará que el lote se haya cerrado. Si se infringe el contrato, el runtime descartará la llamada de forma silenciosa. Un error de validación hará que Close devuelva E_INVALIDARG.

Capa de depuración

La capa de depuración emitirá una advertencia en los mismos casos en los que el runtime producirá un error. La capa de depuración emitirá una advertencia si hay un predicado establecido cuando se llama a ExecuteCommandList. Además, la capa de depuración emitirá un error si detecta que se ha destruido algún recurso al que hace referencia la lista de comandos.
La capa de depuración también validará que el asignador de comandos asociado al lote no se haya restablecido desde que se llamó a Close en la lista de comandos. Esta validación se produce en el momento de ExecuteBundle y cuando la lista de comandos primaria se ejecuta en una cola de comandos.

Ejemplos

El ejemplo D3D12Bundles usa ID3D12GraphicsCommandList::ExecuteBundle de la siguiente manera:
Consulte Código de ejemplo en la referencia de D3D12.

Requisitos

Encabezado: d3d12_xs.h o d3d12_x.h
Biblioteca: d3d12_xs.lib o d3d12_x.lib
Plataformas compatibles: consolas XBOX Series y familia XBOX One

Consulte también

ID3D12GraphicsCommandList
Última modificación el 28 de agosto de 2026