D3D12DDI_RENDER_PASS_ENDING_ACCESS_PRESERVE_LOCAL_PARAMETERS_0101 структура (d3d12umddi.h)

2025-05-11

Структура D3D12DDI_RENDER_PASS_ENDING_ACCESS_PRESERVE_LOCAL_PARAMETERS_0101 определяет параметры для сохранения локальной части ресурса в конце прохода рендеринга.

Синтаксис

typedef struct D3D12DDI_RENDER_PASS_ENDING_ACCESS_PRESERVE_LOCAL_PARAMETERS_0101 {
  UINT AdditionalWidth;
  UINT AdditionalHeight;
} D3D12DDI_RENDER_PASS_ENDING_ACCESS_PRESERVE_LOCAL_PARAMETERS_0101;

Члены

AdditionalWidth

Указывает дополнительную ширину в пикселях, которая должна быть сохранена по обе стороны от сохраненной области. Значение 0 означает, что за пределами указанной области не сохраняются лишние пиксели. См. примечания.

AdditionalHeight

Указывает дополнительную высоту в пикселях, которая должна быть сохранена над и под сохраненной областью. Значение 0 означает, что за пределами указанной области не сохраняются лишние пиксели. См. примечания.

Замечания

Эта структура используется, когда конечным типом доступа для ресурса в рамках прохода отрисовки является одно из следующих значений. Для каждого из этих типов в начале предыдущего прохода должно быть указано соответствующее значение D3D12DDI_RENDER_PASS_BEGINNING_ACCESS_TYPE_0053_PRESERVE_LOCAL_XXX и те же параметры AdditionalWidth/AdditionalHeight .

D3D12DDI_RENDER_PASS_ENDING_ACCESS_TYPE_0101_PRESERVE_LOCAL_RENDER
D3D12DDI_RENDER_PASS_ENDING_ACCESS_TYPE_0101_PRESERVE_LOCAL_SRV
D3D12DDI_RENDER_PASS_ENDING_ACCESS_TYPE_0101_PRESERVE_LOCAL_UAV

AdditionalWidth и AdditionalHeight должны быть установлены в 0 для D3D12DDI_RENDER_PASS_ENDING_ACCESS_TYPE_0101_PRESERVE_LOCAL_RENDER , так как они не имеют смысла в контексте рендеринга.

Если параметры AdditionalWidth/AdditionalHeight для прохода отличны от нуля, они определяют границу дополнительных расположений пикселей вокруг текущего, которые также могут быть прочитаны. Например, AdditionalWidth равным 1 и AdditionalHeight равным 2 означает, что область шириной 3 пикселя и высотой 5 пикселей вокруг текущего пикселя может быть прочитана текущим пикселем.

Дополнительные сведения см. в статье D3D12 Render Passes.