Fungsi D3D12SerializeVersionedRootSignature (d3d12.h)

Artikel
02/26/2024

Membuat serialisasi tanda tangan akar dari versi apa pun yang dapat diteruskan ke ID3D12Device::CreateRootSignature.

Sintaks

HRESULT D3D12SerializeVersionedRootSignature(
  [in]            const D3D12_VERSIONED_ROOT_SIGNATURE_DESC *pRootSignature,
  [out]           ID3DBlob                                  **ppBlob,
  [out, optional] ID3DBlob                                  **ppErrorBlob
);

Parameter

[in] pRootSignature

Jenis: const D3D12_VERSIONED_ROOT_SIGNATURE_DESC*

Menentukan D3D12_VERSIONED_ROOT_SIGNATURE_DESC yang berisi deskripsi versi tanda tangan akar apa pun.

[out] ppBlob

Jenis: ID3DBlob**

Penunjuk ke blok memori yang menerima penunjuk ke antarmuka ID3DBlob yang dapat Anda gunakan untuk mengakses tanda tangan akar yang diserialisasikan.

[out, optional] ppErrorBlob

Jenis: ID3DBlob**

Penunjuk ke blok memori yang menerima penunjuk ke antarmuka ID3DBlob yang dapat Anda gunakan untuk mengakses pesan kesalahan serializer, atau NULL jika tidak ada kesalahan.

Nilai kembali

Jenis: HRESULT

Mengembalikan S_OK jika berhasil; jika tidak, mengembalikan salah satu Kode Pengembalian Direct3D 12.

Keterangan

Jika aplikasi secara prosedural menghasilkan struktur data D3D12_ROOT_SIGNATURE_DESC1 , aplikasi harus meneruskan penunjuk ke D3D12_ROOT_SIGNATURE_DESC1 ini dalam panggilan ke D3D12SerializeVersionedRootSignature untuk membuat formulir berseri. Aplikasi kemudian meneruskan formulir berseri yang ditunjukkan ppBlob ke ID3D12Device::CreateRootSignature.

Jika shader telah ditulis dengan tanda tangan akar di dalamnya, shader yang dikompilasi akan berisi tanda tangan akar berseri di dalamnya. Dalam hal ini, teruskan blob shader yang dikompilasi ke ID3D12Device::CreateRootSignature untuk mendapatkan objek tanda tangan akar runtime.

Perhatikan bahwa untuk pengembang Xbox, penggunaan tanda tangan akar yang ditulis HLSL sangat disarankan.

Tanda tangan fungsi PFN_D3D12_SERIALIZE_VERSIONED_ROOT_SIGNATURE disediakan sebagai typedef, sehingga Anda dapat menggunakan teknik penautan dinamis (GetProcAddress) alih-alih menautkan secara statis.

Fungsi ini dirilis dengan Windows 10 Anniversary Update (14393) dan menggantikan D3D12SerializeRootSignature.