Pular para o conteúdo principal
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

Parâmetros

pDstData [out]
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 até a próxima linha. DstDepthPitch
Tipo: UINT
A distância de uma fatia de profundidade de dados de destino até a próxima. SrcSubresource
Tipo: UINT
Especifica o índice do sub-recurso do qual ler. pSrcBox [in, optional]
Tipo: const D3D12_BOX *
Um ponteiro para uma caixa que define a parte do sub-recurso de destino da qual copiar os dados do recurso. Se for NULL, os dados serão lidos do sub-recurso de destino sem deslocamento. As dimensões do destino devem caber no destino (consulte D3D12_BOX). Uma caixa vazia resulta em nenhuma operação. Uma caixa está vazia se o valor superior for maior ou igual ao valor inferior, ou se o valor esquerdo for maior ou igual ao valor direito, ou se o valor frontal for maior ou igual ao valor traseiro. Quando a caixa está vazia, este método não executa nenhuma operação.

Valor retornado

Tipo: HRESULT Este método retorna um dos Códigos de retorno do Direct3D 12.

Comentários

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

Requisitos

Cabeçalho: d3d12_xs.h ou d3d12_x.h
Biblioteca: d3d12_xs.lib ou d3d12_x.lib
Plataformas com suporte: consoles XBOX Series e família XBOX One

Confira também

ID3D12Resource Sub-recursos
Última modificação em 6 de outubro de 2026