Metodo ID3D12GraphicsCommandList1::ResolveSubresourceRegion (d3d12.h)

Copiare un'area di una risorsa con multicampionamento o compresso in una risorsa non multicampionata o non compressa.

Sintassi

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
);

Parametri

[in] pDstResource

Tipo: ID3D12Resource*

SAL: In

Risorsa di destinazione. Deve essere creato con il flag D3D11_USAGE_DEFAULT e deve essere sottoposto a campionamento singolo a meno che non venga risolto da una risorsa compressa (D3D12_RESOLVE_MODE_DECOMPRESS); in questo caso deve avere lo stesso numero di campioni dell'origine compressa.

[in] DstSubresource

Tipo: UINT

SAL: In

Indice in base zero che identifica la sottorisorsa di destinazione. Usare D3D12CalcSubresource per calcolare l'indice della sottorisorsa se la risorsa padre è complessa.

[in] DstX

Tipo: UINT

SAL: In

Coordinata X del bordo più a sinistra dell'area di destinazione. La larghezza dell'area di destinazione corrisponde alla larghezza del rect di origine.

[in] DstY

Tipo: UINT

SAL: In

Coordinata Y del bordo superiore dell'area di destinazione. L'altezza dell'area di destinazione corrisponde all'altezza del rect di origine.

[in] pSrcResource

Tipo: ID3D12Resource*

SAL: In

Risorsa di origine. Deve essere multicampionato o compresso.

[in] SrcSubresource

Tipo: UINT

SAL: In

Indice in base zero che identifica la sottorisorsa di origine.

[in, optional] pSrcRect

Tipo: D3D12_RECT*

SAL: In_opt

Specifica l'area rettangolare della risorsa di origine da risolvere. Il passaggio di NULL per pSrcRect specifica che l'intera sottorisorsa deve essere risolta.

[in] Format

Tipo: DXGI_FORMAT

SAL: In

Oggetto DXGI_FORMAT che specifica come vengono consolidati i formati delle risorse di origine e di destinazione.

[in] ResolveMode

Tipo: D3D12_RESOLVE_MODE

SAL: In

Specifica l'operazione utilizzata per risolvere i campioni di origine.

Quando si usa l'operazione di D3D12_RESOLVE_MODE_DECOMPRESS , il conteggio dei campioni può essere maggiore di 1, purché l'origine e la destinazione abbiano lo stesso numero di campioni e l'origine e la destinazione possono specificare la stessa risorsa purché la correzione di origine sia allineata alle coordinate X e Y di destinazione, nel qual caso si verifica la decompressione sul posto.

Quando si usa l'operazione di D3D12_RESOLVE_MODE_MIN, D3D12_RESOLVE_MODE_MAX o D3D12_RESOLVE_MODE_AVERAGE , la destinazione deve avere un numero di campioni pari a 1.

Valore restituito

nessuno

Osservazioni

ResolveSubresourceRegion funziona come ResolveSubresource , ma consente di risolvere solo parte di una risorsa e di risolvere i campioni di origine in diversi modi. Le operazioni di risoluzione parziali possono essere utili negli scenari con più adattatori; Ad esempio, quando l'area sottoposta a rendering è stata partizionata tra schede, ogni adattatore potrebbe dover risolvere solo la parte di una sottorisorsa corrispondente alla partizione assegnata.

Requisiti

Vedi anche

ID3D12GraphicsCommandList1