Fungsi NdisQueryAdapterInstanceName (ndis.h)

Fungsi NdisQueryAdapterInstanceName mengambil nama yang mudah diingat dari NIC fisik atau adaptor virtual yang terikat dengan driver protokol panggilan.

Sintaks

NDIS_STATUS NdisQueryAdapterInstanceName(
       PNDIS_STRING pAdapterInstanceName,
  [in] NDIS_HANDLE  NdisBindingHandle
);

Parameter

pAdapterInstanceName

Penunjuk ke jenis NDIS_STRING yang disediakan penelepon yang menerima string Unicode yang dihitung. String ini menentukan nama antarmuka yang mudah diingat yang dirujuk oleh pengikatan. Antarmuka ini adalah NIC fisik atau adaptor virtual. Untuk Windows 2000 dan yang lebih baru, NDIS menentukan jenis NDIS_STRING sebagai jenis UNICODE_STRING .

[in] NdisBindingHandle

Handel yang mengidentifikasi pengikatan ke NIC fisik target atau adaptor virtual dari driver berikutnya yang lebih rendah tempat pemanggil terikat. Biasanya, NdisBindingHandle dikembalikan oleh fungsi NdisOpenAdapterEx .

Nilai kembali

NdisQueryAdapterInstanceName mengembalikan NDIS_STATUS_SUCCESS jika memori untuk string di AdapterInstanceName berhasil dialokasikan; jika tidak, ia mengembalikan NDIS_STATUS_RESOURCES.

Keterangan

Driver protokol menggunakan NdisQueryAdapterInstanceName untuk mengambil nama yang mudah diingat dari NIC fisik atau adaptor virtual tempat driver protokol terikat. Driver protokol menentukan handel ke NIC atau adaptor virtual seperti itu di NdisBindingHandle . Driver protokol memanggil fungsi NdisOpenAdapterEx untuk mengambil handel ini.

NdisQueryAdapterInstanceName mengalokasikan memori untuk string yang menentukan nama yang mudah diingat. Setelah pemanggil selesai menggunakan memori ini, pemanggil harus memanggil fungsi NdisFreeMemory untuk melepaskan memori.

Nama yang mudah diingat dimaksudkan untuk membantu pengguna dengan cepat dan akurat mengidentifikasi NIC fisik atau adaptor virtual--misalnya, "Adaptor Ethernet PCI" dan "Adapter Jaringan Privat Virtual" dianggap sebagai nama yang ramah.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung untuk driver NDIS 6.0 dan NDIS 5.1 (lihat NdisQueryAdapterInstanceName (NDIS 5.1)) di Windows Vista. Didukung untuk driver NDIS 5.1 (lihat NdisQueryAdapterInstanceName (NDIS 5.1)) di Windows XP.
Target Platform	Desktop
Header	ndis.h (termasuk Ndis.h)
Pustaka	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Aturan kepatuhan DDI	Irql_Miscellaneous_Function(ndis)

Lihat juga

NdisFreeMemory

NdisOpenAdapterEx

UNICODE_STRING