Метод ID3D12GraphicsCommandList1::ResolveSubresourceRegion (d3d12.h)

  • Статья

Скопируйте область ресурса с несколькими выборками или сжатым ресурсом в ресурс без нескольких выборок или не сжатый ресурс.

Синтаксис

void ResolveSubresourceRegion(
  [in]           ID3D12Resource     *pDstResource,
  [in]           UINT               DstSubresource,
  [in]           UINT               DstX,
  [in]           UINT               DstY,
  [in]           ID3D12Resource     *pSrcResource,
  [in]           UINT               SrcSubresource,
  [in, optional] D3D12_RECT         *pSrcRect,
  [in]           DXGI_FORMAT        Format,
  [in]           D3D12_RESOLVE_MODE ResolveMode
);

Параметры

[in] pDstResource

Тип: ID3D12Ресурс*

SAL: In

Целевой ресурс. Должен быть создан с флагом D3D11_USAGE_DEFAULT и должен быть одним образцом, если только он не разрешается из сжатого ресурса (D3D12_RESOLVE_MODE_DECOMPRESS); в этом случае он должен иметь то же количество выборок, что и сжатый источник.

[in] DstSubresource

Тип: UINT

SAL: In

Отсчитываемый от нуля индекс, идентифицирующий целевой подресурс. Используйте D3D12CalcSubresource для вычисления индекса подресурса, если родительский ресурс является сложным.

[in] DstX

Тип: UINT

SAL: In

Координата X левого края области назначения. Ширина области назначения совпадает с шириной исходного прямоугольника.

[in] DstY

Тип: UINT

SAL: In

Координата Y верхнего края области назначения. Высота области назначения совпадает с высотой исходного прямоугольника.

[in] pSrcResource

Тип: ID3D12Ресурс*

SAL: In

Исходный ресурс. Должен быть многостранинным или сжатым.

[in] SrcSubresource

Тип: UINT

SAL: In

Отсчитываемый от нуля индекс, идентифицирующий исходный подресурс.

[in, optional] pSrcRect

Тип: D3D12_RECT*

SAL: In_opt

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

[in] Format

Тип: DXGI_FORMAT

SAL: In

DXGI_FORMAT, указывающий способ объединения исходного и целевого форматов ресурсов.

[in] ResolveMode

Тип: D3D12_RESOLVE_MODE

SAL: In

Указывает операцию, используемую для разрешения исходных выборок.

При использовании операции D3D12_RESOLVE_MODE_DECOMPRESS количество выборок может быть больше 1, если источник и назначение имеют одинаковое количество выборок, а источник и назначение могут указывать один и тот же ресурс, если исходный прямоугольник выравнивается с координатами назначения X и Y, в этом случае происходит распаковка.

При использовании операции D3D12_RESOLVE_MODE_MIN, D3D12_RESOLVE_MODE_MAX или D3D12_RESOLVE_MODE_AVERAGE назначение должно иметь число выборок 1.

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

None

Remarks

ResolveSubresourceRegion работает так же, как ResolveSubresource , но позволяет разрешить только часть ресурса, а для исходных примеров — несколькими способами. Частичные разрешения могут быть полезны в сценариях с несколькими адаптерами; Например, если отрисоченная область секционирована по адаптерам, каждому адаптеру может потребоваться разрешить только часть подресурса, соответствующую назначенной секции.

Требования

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

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

ID3D12GraphicsCommandList1