Метод 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 , но позволяет разрешить только часть ресурса, а для исходных примеров — несколькими способами. Частичные разрешения могут быть полезны в сценариях с несколькими адаптерами; Например, если отрисоченная область секционирована по адаптерам, каждому адаптеру может потребоваться разрешить только часть подресурса, соответствующую назначенной секции.

Требования

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

ID3D12GraphicsCommandList1