Método ID3D11ShaderTrace::GetInitialRegisterContents (d3d11shadertracing.h)

Recupera o conteúdo inicial do registro de entrada especificado.

Sintaxe

HRESULT GetInitialRegisterContents(
  [in]  D3D11_TRACE_REGISTER *pRegister,
  [out] D3D11_TRACE_VALUE    *pValue
);

Parâmetros

[in] pRegister

Um ponteiro para uma estrutura D3D11_TRACE_REGISTER que descreve o registro de entrada do qual recuperar o conteúdo inicial. Você pode recuperar dados iniciais válidos apenas dos seguintes tipos de registro de entrada. Ou seja, para recuperar dados válidos, o membro RegType do D3D11_TRACE_REGISTER deve ser um dos seguintes valores:

  • D3D11_TRACE_INPUT_REGISTER
  • D3D11_TRACE_INPUT_PRIMITIVE_ID_REGISTER
  • D3D11_TRACE_IMMEDIATE_CONSTANT_BUFFER
Os dados válidos são indicados pelo membro ValidMask da estrutura de D3D11_TRACE_VALUE para a qual pValue aponta.

[out] pValue

Um ponteiro para uma estrutura D3D11_TRACE_VALUE . GetInitialRegisterContents preenche os membros dessa estrutura com informações sobre o conteúdo inicial.

Retornar valor

GetInitialRegisterContents retorna:

  • S_OK se o método recuperar o conteúdo do registro inicial.
  • E_FAIL se um rastreamento não estiver disponível.
  • E_INVALIDARG se pRegister for inválido ou NULL ou se pValue for NULL.
  • Possivelmente outros códigos de erro descritos em Códigos de Retorno do Direct3D 11.

Comentários

Você pode chamar GetInitialRegisterContents para registros diferentes dos tipos de registro de entrada especificados na descrição do parâmetro pRegister . No entanto, GetInitialRegisterContents define o membro ValidMask da estrutura D3D11_TRACE_VALUE à qual pValue aponta para vazio (todos os zeros, 0000) e os valores de registro que o membro Bits de D3D11_TRACE_VALUE especifica não têm sentido. Os dados retornados por GetInitialRegisterContents não são afetados por um rastreamento; no entanto, os dados retornados são afetados pela alteração do índice de selo por meio de uma chamada para ID3D11ShaderTrace::P SSelectStamp.

Nota Essa API requer o SDK (Software Development Kit) do Windows para Windows 8.
 

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho d3d11shadertracing.h
DLL D3D11SDKLayers.dll; D3D11_1SDKLayers.dll; D3D11_2SDKLayers.dll

Confira também

ID3D11ShaderTrace