Metode IDMLBindingTable::BindPersistentResource (directml.h)

Mengikat buffer sebagai sumber daya persisten. Anda dapat menentukan ukuran rentang buffer yang diperlukan dengan memanggil IDMLDispatchable::GetBindingProperties.

Jika properti pengikatan untuk operator menentukan ukuran nol untuk sumber daya persisten, maka Anda dapat menyediakan nullptr ke metode ini (yang menunjukkan tidak ada sumber daya yang akan diikat). Jika tidak, pengikatan jenis DML_BINDING_TYPE_BUFFER harus disediakan yang setidaknya sebesar PersistentResourceSize yang diperlukan yang dikembalikan oleh IDMLDispatchable::GetBindingProperties.

Tidak seperti sumber daya sementara, konten dan masa pakai sumber daya persisten harus bertahan selama operator yang dikompilasi. Artinya, jika operator memerlukan sumber daya persisten, maka aplikasi Anda harus menyediakannya selama inisialisasi dan kemudian juga menyediakannya ke semua eksekusi operator di masa mendatang tanpa memodifikasi kontennya.

Sumber daya persisten biasanya digunakan oleh DirectML untuk menyimpan tabel pencarian atau data berumur panjang lainnya yang dihitung selama inisialisasi operator dan digunakan kembali pada eksekusi operator tersebut di masa mendatang.

Karena data sumber daya persisten buram, setelah diinisialisasi, data tersebut tidak dapat disalin atau dipindahkan ke buffer lain.

Sumber daya persisten hanya ditulis selama inisialisasi operator dan setelahnya tidak dapat diubah; semua eksekusi berikutnya dijamin tidak menulis ke sumber daya persisten.

Rentang buffer yang disediakan untuk terikat karena buffer persisten harus memiliki offset awal yang selaras dengan DML_PERSISTENT_BUFFER_ALIGNMENT. Jenis timbunan yang mendasar buffer harus D3D12_HEAP_TYPE_DEFAULT.

Sintaks

void BindPersistentResource(
  [in, optional] const DML_BINDING_DESC *binding
);

Parameter

[in, optional] binding

Jenis: const DML_BINDING_DESC*

Penunjuk opsional ke DML_BINDING_DESC yang berisi deskripsi sumber daya tensor untuk mengikat.

Nilai kembali

Tidak ada

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	directml.h
Pustaka	DirectML.lib
DLL	DirectML.dll

Lihat juga

Pengikatan di DirectML

IDMLBindingTable