Поделиться через

Метод ID3D11ShaderTrace::GetInitialRegisterContents (d3d11shadertracing.h)

  • Статья

Извлекает начальное содержимое указанного входного регистра.

Синтаксис

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

Параметры

[in] pRegister

Указатель на структуру D3D11_TRACE_REGISTER , описывающую входной регистр, из которого извлекается начальное содержимое. Допустимые начальные данные можно получить только из следующих типов входных регистров. То есть для получения допустимых данных элемент RegTypeD3D11_TRACE_REGISTER должен иметь одно из следующих значений:

  • D3D11_TRACE_INPUT_REGISTER
  • D3D11_TRACE_INPUT_PRIMITIVE_ID_REGISTER
  • D3D11_TRACE_IMMEDIATE_CONSTANT_BUFFER
Допустимые данные указываются элементом ValidMaskструктуры D3D11_TRACE_VALUE , на которую указывает pValue .

[out] pValue

Указатель на структуру D3D11_TRACE_VALUE . GetInitialRegisterContents заполняет элементы этой структуры сведениями об исходном содержимом.

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

GetInitialRegisterContents возвращает:

  • S_OK , извлекает ли метод начальное содержимое регистра.
  • E_FAIL , если трассировка недоступна.
  • E_INVALIDARG , если pRegister является недопустимым или null или если pValue имеет значение NULL.
  • Возможно, другие коды ошибок, описанные в разделе Коды возврата Direct3D 11.

Комментарии

Метод GetInitialRegisterContents можно вызвать для регистров, отличных от типов входных регистров, указанных в описании параметра pRegister . Однако GetInitialRegisterContents задает элемент ValidMaskструктуры D3D11_TRACE_VALUE , на который pValue указывает пустое значение (все нули, 0000), а значения регистра, которые указывает элемент BitsD3D11_TRACE_VALUE , являются бессмысленными. На данные, возвращаемые GetInitialRegisterContents , не влияет пошаговое выполнение трассировки; Однако на возвращаемые данные влияет изменение индекса метки с помощью вызова ID3D11ShaderTrace::P SSelectStamp.

Примечание Для этого API требуется пакет средств разработки программного обеспечения Windows (SDK) для Windows 8.
 

Требования

Требование Значение
Минимальная версия клиента Windows 8 [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2012 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header d3d11shadertracing.h
DLL D3D11SDKLayers.dll; D3D11_1SDKLayers.dll; D3D11_2SDKLayers.dll

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

ID3D11ShaderTrace