Fungsi NdisInitializeString (ndis.h)

Artikel
02/26/2024

Fungsi NdisInitializeString mengalokasikan penyimpanan untuk dan menginisialisasi string yang dihitung dalam kumpulan karakter default sistem.

Sintaks

void NdisInitializeString(
  PNDIS_STRING Destination,
  PUCHAR       Source
);

Parameter

Destination

Penunjuk ke NDIS_STRING dengan buffer NULL . Saat dikembalikan dari fungsi ini, NDIS_STRING berisi string yang diinisialisasi dan dihitung. Untuk Windows 2000 dan yang lebih baru, NDIS menentukan jenis NDIS_STRING sebagai jenis UNICODE_STRING .

Source

Penunjuk ke string yang dihentikan null untuk menginisialisasi string yang dihitung. SourceString tidak boleh NULL.

Nilai kembali

Tidak ada

Keterangan

NdisInitializeString mengatur anggota Panjang dan MaximumLength dari NDIS_STRING untuk string tujuan dan mengakhiri string tujuan dengan nol. Untuk driver Windows 2000 dan yang lebih baru, NdisInitializeString mengonversi string sumber yang disediakan menjadi karakter Unicode.

SourceString tidak boleh NULL.

Buffer yang dialokasikan oleh NdisInitializeString harus dirilis dengan fungsi NdisFreeString .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung untuk driver yang ada di NDIS 6.0 dan yang lebih baru, tetapi driver baru harus menggunakan RtlInitUnicodeString atau RTL_CONSTANT_STRING atau DECLARE_CONST_UNICODE_STRING (lihat ntdef.h) sebagai gantinya.
Target Platform	Universal
Header	ndis.h (termasuk Ndis.h)
Pustaka	Ndis.lib
IRQL	PASSIVE_LEVEL
Aturan kepatuhan DDI	Irql_Miscellaneous_Function(ndis)