Метод ID3D11DeviceContext::ExecuteCommandList (d3d11.h)

  • Статья

Помещает команды из списка команд в очередь на устройство.

Синтаксис

void ExecuteCommandList(
  [in] ID3D11CommandList *pCommandList,
       BOOL              RestoreContextState
);

Параметры

[in] pCommandList

Тип: ID3D11CommandList*

Указатель на интерфейс ID3D11CommandList , инкапсулирующий список команд.

RestoreContextState

Тип: BOOL

Логический флаг, определяющий, сохраняется ли целевое состояние контекста до и восстанавливается после выполнения списка команд. Используйте значение TRUE , чтобы указать, что среде выполнения необходимо сохранить и восстановить состояние. Используйте значение FALSE , чтобы указать, что состояние не должно сохраняться или восстанавливаться, что приводит к возвращению целевого контекста в состояние по умолчанию после выполнения списка команд. Приложения, как правило, должны использовать ЗНАЧЕНИЕ FALSE , если только они не будут восстанавливать состояние почти эквивалентно состоянию, которое среда выполнения восстановит при передаче TRUE . Если приложения используют FALSE, они могут избежать ненужных и неэффективных переходов состояния.

Возвращаемое значение

None

Remarks

Используйте этот метод для воспроизведения списка команд, записанного отложенным контекстом в любом потоке.

Вызов ExecuteCommandList списка команд из отложенного контекста в непосредственный контекст требуется для выполнения записанных команд в графическом процессоре (GPU). Вызов ExecuteCommandList списка команд из отложенного контекста в другой отложенный контекст можно использовать для слияния записанных списков. Но чтобы выполнить команды из объединенного списка отложенных команд на GPU, необходимо выполнить их в непосредственном контексте.

Этот метод выполняет проверку среды выполнения, связанную с запросами. Запросы, запущенные в контексте устройства, не могут обрабатываться косвенно путем выполнения списка команд (то есть начало или конец были вызваны для того же запроса отложенным контекстом, который создал список команд). Если возникает такое условие, метод ExecuteCommandList не выполняет список команд. Однако состояние контекста устройства по-прежнему сохраняется, как и ожидалось (выполняется ID3D11DeviceContext::ClearState , если приложение не указывает на сохранение состояния контекста устройства).

Windows Phone 8. Этот API поддерживается.

Требования

Требование Значение
Целевая платформа Windows
Header d3d11.h
Библиотека D3d11.lib

См. также раздел

ID3D11DeviceContext