Método ID3D12Resource::ReadFromSubresource (d3d12.h)

Usa a CPU para copiar dados de um sub-recurso, permitindo que a CPU leia o conteúdo da maioria das texturas com layouts indefinidos.

Sintaxe

HRESULT ReadFromSubresource(
  [out]          void            *pDstData,
                 UINT            DstRowPitch,
                 UINT            DstDepthPitch,
                 UINT            SrcSubresource,
  [in, optional] const D3D12_BOX *pSrcBox
);

Parâmetros

[out] pDstData

Tipo: void*

Um ponteiro para os dados de destino na memória.

DstRowPitch

Tipo: UINT

A distância de uma linha de dados de destino para a próxima linha.

DstDepthPitch

Tipo: UINT

A distância de uma fatia de profundidade dos dados de destino para a próxima.

SrcSubresource

Tipo: UINT

Especifica o índice do sub-recurso do qual ler.

[in, optional] pSrcBox

Tipo: const D3D12_BOX*

Um ponteiro para uma caixa que define a parte do sub-recurso de destino para copiar os dados do recurso. Se NULL, os dados serão lidos do sub-recurso de destino sem deslocamento. As dimensões do destino devem se ajustar ao destino (consulte D3D12_BOX).

Uma caixa vazia resulta em uma no-op. Uma caixa estará vazia se o valor superior for maior ou igual ao valor inferior ou o valor esquerdo for maior ou igual ao valor à direita ou o valor frontal for maior ou igual ao valor de fundo. Quando a caixa está vazia, esse método não executa nenhuma operação.

Valor retornado

Tipo: HRESULT

Esse método retorna um dos códigos de retorno do Direct3D 12.

Comentários

Consulte a seção Comentários para WriteToSubresource.

Requisitos

Plataforma de Destino	Windows
Cabeçalho	d3d12.h
Biblioteca	D3d12.lib
DLL	D3d12.dll

Confira também

ID3D12Resource

Sub-recursos