Метод ID3D12GraphicsCommandList::ResolveSubresource (d3d12.h)

Статья
08/23/2023

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

Синтаксис

void ResolveSubresource(
  ID3D12Resource *pDstResource,
  UINT           DstSubresource,
  ID3D12Resource *pSrcResource,
  UINT           SrcSubresource,
  DXGI_FORMAT    Format
);

Параметры

pDstResource

Тип: [in] ID3D12Resource*

Целевой ресурс. Должен быть созданным в куче D3D12_HEAP_TYPE_DEFAULT и быть одной выборкой. См . ID3D12Resource.

DstSubresource

Тип: [in] UINT

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

pSrcResource

Тип: [in] ID3D12Resource*

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

SrcSubresource

Тип: [in] UINT

Исходный подресурс исходного ресурса.

Format

Тип: [in] DXGI_FORMAT

DXGI_FORMAT, указывающий, как ресурс с несколькими выборками будет разрешаться в ресурс с одной выборкой. См. примечания.

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

None

Remarks

Уровень отладки

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

Уровень отладки выдает ошибку, если буфер назначения не находится в состоянии D3D12_RESOURCE_STATE_RESOLVE_DEST .

Исходный и целевой ресурсы должны иметь один и тот же тип ресурса и иметь одинаковые измерения. Кроме того, они должны иметь совместимые форматы. Для этого существует три сценария:

Сценарий	Требования
Источник и назначение предварительно структурированы и типизированы	Исходный и целевой форматы должны иметь одинаковый формат, и этот формат должен быть указан в параметре Format.
Один ресурс является предварительно структурированным и типизированным, а другой — предварительно структурированным и нетипизированным.	Типизированный ресурс должен иметь формат, совместимый с бестипным ресурсом (т. е. типизированный ресурс является DXGI_FORMAT_R32_FLOAT, а нетипизированный ресурс — DXGI_FORMAT_R32_TYPELESS). Формат типизированного ресурса должен быть указан в параметре Format.
Источник и назначение являются предварительно структурированными и нетипизированными	Исходный и целевой формат должны иметь одинаковый бестипный формат (т. е. оба должны иметь DXGI_FORMAT_R32_TYPELESS), а параметр Format должен указывать формат, совместимый с источником и назначением (т. е. если они DXGI_FORMAT_R32_TYPELESS то DXGI_FORMAT_R32_FLOAT можно указать в параметре Format). Например, при использовании формата DXGI_FORMAT_R16G16B16A16_TYPELESS: Формат источника (или деста) может быть DXGI_FORMAT_R16G16B16A16_UNORM Формат dest (или source) может быть DXGI_FORMAT_R16G16B16A16_FLOAT

Требования


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

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

ID3D12GraphicsCommandList

Подресурсы