METODE ID3D11ShaderTrace::GetInitialRegisterContents (d3d11shadertracing.h)

Artikel
02/20/2025

Mengambil konten awal dari register input yang ditentukan.

Sintaks

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

Parameter

[in] pRegister

Pointer ke struktur D3D11_TRACE_REGISTER yang menjelaskan register input untuk mengambil konten awal. Anda dapat mengambil data awal yang valid hanya dari jenis register input berikut. Artinya, untuk mengambil data yang valid, anggota RegTypedari D3D11_TRACE_REGISTER harus menjadi salah satu nilai berikut:

D3D11_TRACE_INPUT_REGISTER
D3D11_TRACE_INPUT_PRIMITIVE_ID_REGISTER
D3D11_TRACE_IMMEDIATE_CONSTANT_BUFFER

Data yang valid ditunjukkan oleh anggota ValidMask dari struktur D3D11_TRACE_VALUE yang ditunjukkan pValue .

[out] pValue

Penunjuk ke struktur D3D11_TRACE_VALUE . GetInitialRegisterContents mengisi anggota struktur ini dengan informasi tentang konten awal.

Nilai kembali

GetInitialRegisterContents mengembalikan:

S_OK jika metode mengambil konten register awal.
E_FAIL jika jejak tidak tersedia.
E_INVALIDARG jika pRegister tidak valid atau NULL atau jika pValue NULL.
Mungkin kode kesalahan lain yang dijelaskan dalam Direct3D 11 Return Codes.

Keterangan

Anda dapat memanggil GetInitialRegisterContents untuk register selain jenis register input yang ditentukan dalam deskripsi parameter pRegister . Namun, GetInitialRegisterContents menetapkan anggota ValidMask dari struktur D3D11_TRACE_VALUE yang menunjuk pValue ke kosong (semua nol, 0000), dan nilai register yang ditentukan anggota Bits dari D3D11_TRACE_VALUE tidak ada artinya. Data yang dikembalikan GetInitialRegisterContents tidak terpengaruh oleh langkah dalam pelacakan; namun, data yang dikembalikan dipengaruhi oleh mengubah indeks stempel melalui panggilan ke ID3D11ShaderTrace::P SSelectStamp.

Catatan API ini memerlukan Windows Software Development Kit (SDK) untuk Windows 8.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2012 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	d3d11shadertracing.h
DLL	D3D11SDKLayers.dll; D3D11_1SDKLayers.dll; D3D11_2SDKLayers.dll

Lihat juga

ID3D11ShaderTrace

Bagikan melalui