функция обратного вызова PFND3D11DDI_DESTROYCOMMANDLIST (d3d10umddi.h)
Функция DestroyCommandList уничтожает список команд.
Синтаксис
PFND3D11DDI_DESTROYCOMMANDLIST Pfnd3d11ddiDestroycommandlist;
void Pfnd3d11ddiDestroycommandlist(
D3D10DDI_HDEVICE unnamedParam1,
D3D11DDI_HCOMMANDLIST unnamedParam2
)
{...}
Параметры
unnamedParam1
hDevice [in]
Дескриптор устройства отображения (графический контекст).
unnamedParam2
hCommandList [in]
Дескриптор частных данных драйвера для уничтожения списка команд. Среда выполнения Microsoft Direct3D освобождает область памяти, выделенную ранее для списка команд. Таким образом, драйвер больше не может получить доступ к этому региону памяти.
Возвращаемое значение
Никакой
Замечания
Драйвер может использовать функцию обратного вызова pfnSetErrorCb для задания кода ошибки.
Драйвер требуется только для реализации DestroyCommandList, если драйвер поддерживает возможность D3D11DDICAPS_COMMANDLISTS_BUILD_2, которую можно вернуть в структуре D3D11DDI_THREADING_CAPS из вызова функции GetCaps(D3D10_2).
Драйвер не должен столкнуться с ошибкой, за исключением D3DDDIERR_DEVICEREMOVED. Таким образом, если драйвер передает любую ошибку, за исключением D3DDDIERR_DEVICEREMOVED, при вызове функции pfnSetErrorCb среда выполнения Direct3D определяет, что ошибка является критической. Даже если устройство удалено, драйвер не требуется возвращать D3DDDIERR_DEVICEREMOVED; Однако если удаление устройства мешает работе DestroyCommandList (что обычно не должно произойти), драйвер может вернуть D3DDDIERR_DEVICEREMOVED.
Драйвер может реализовать функцию DestroyCommandList, содержащую инструкцию переключателя для обработки уничтожения списков команд и упрощенного уничтожения списков команд. То есть драйвер может реализовать один элемент DestroyCommandList, и может задать pfnRecycleDecycleCommandList член структуры D3D11DDI_DEVICEFUNCS, чтобы указать DestroyCommandList вместе с pfnRecycleDecycleDeandCommandList член D3D11DDI_DEVICEFUNCS, чтобы указать на DestroyCommandList. Однако для повышения производительности драйвер может реализовать отдельные функции DestroyCommandList и RecycleDeskCommandList.
Дополнительные сведения о RecycleDecommandListсм. в оптимизации для небольших списков команд.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | DestroyCommandList поддерживается начиная с операционной системы Windows 7. |
| целевая платформа | Настольный |
| заголовка | d3d10umddi.h (include D3d10umddi.h) |