NdisQueryAdapterInstanceName-Funktion (ndis.h)

Die NdisQueryAdapterInstanceName-Funktion ruft den Anzeigenamen einer physischen NIC oder eines virtuellen Adapters ab, an die der aufrufende Protokolltreiber gebunden ist.

Syntax

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

Parameter

pAdapterInstanceName

Ein Zeiger auf einen vom Aufrufer bereitgestellten NDIS_STRING Typ, der eine gezählte Unicode-Zeichenfolge empfängt. Diese Zeichenfolge gibt den Anzeigenamen der Schnittstelle an, auf die die Bindung verweist. Diese Schnittstelle ist entweder eine physische NIC oder ein virtueller Adapter. Für Windows 2000 und höher definiert NDIS den NDIS_STRING Typ als UNICODE_STRING Typ.

[in] NdisBindingHandle

Ein Handle, das die Bindung an die physische Zielnic oder den virtuellen Adapter des nächstniedrigen Treibers identifiziert, an den der Aufrufer gebunden ist. In der Regel wurde NdisBindingHandle von der NdisOpenAdapterEx-Funktion zurückgegeben.

Rückgabewert

NdisQueryAdapterInstanceName gibt NDIS_STATUS_SUCCESS zurück, wenn arbeitsspeicher für die Zeichenfolge unter AdapterInstanceName erfolgreich zugeordnet wurde; Andernfalls wird NDIS_STATUS_RESOURCES zurückgegeben.

Hinweise

Ein Protokolltreiber verwendet NdisQueryAdapterInstanceName , um den Anzeigenamen einer physischen Netzwerkkarte oder eines virtuellen Adapters abzurufen, an den der Protokolltreiber gebunden ist. Der Protokolltreiber gibt das Handle für eine solche NIC oder einen virtuellen Adapter in NdisBindingHandle an. Der Protokolltreiber ruft die NdisOpenAdapterEx-Funktion auf, um dieses Handle abzurufen.

NdisQueryAdapterInstanceName weist Arbeitsspeicher für die Zeichenfolge zu, die den Anzeigenamen angibt. Nachdem der Aufrufer die Verwendung dieses Speichers abgeschlossen hat, muss der Aufrufer die NdisFreeMemory-Funktion aufrufen, um den Arbeitsspeicher freizugeben.

Anzeigenamen sollen dem Benutzer dabei helfen, eine physische Netzwerkkarte oder einen virtuellen Adapter schnell und genau zu identifizieren. Beispielsweise werden "PCI-Ethernet-Adapter" und "Virtueller privater Netzwerkadapter" als Anzeigenamen betrachtet.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt für NDIS 6.0- und NDIS 5.1-Treiber (siehe NdisQueryAdapterInstanceName (NDIS 5.1)) in Windows Vista. Unterstützt für NDIS 5.1-Treiber (siehe NdisQueryAdapterInstanceName (NDIS 5.1)) in Windows XP.
Zielplattform	Desktop
Kopfzeile	ndis.h (include Ndis.h)
Bibliothek	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI-Complianceregeln	Irql_Miscellaneous_Function(ndis)

Weitere Informationen

NdisFreeMemory

NdisOpenAdapterEx

UNICODE_STRING