NdisQueryBindInstanceName-Funktion (ndis.h)

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

Syntax

NDIS_STATUS NdisQueryBindInstanceName(
  [out] PNDIS_STRING pAdapterInstanceName,
  [in]  NDIS_HANDLE  BindingContext
);

Parameter

[out] 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 Microsoft Windows 2000 und höhere Betriebssysteme definiert NDIS den NDIS_STRING Typ als UNICODE_STRING Typ.

[in] BindingContext

Ein Handle, das den NDIS-Kontextbereich für den Bindungsvorgang identifiziert. NDIS hat dieses Handle an den BindContext-Parameter des ProtocolBindAdapterEx-Funktion .

Rückgabewert

NdisQueryBindInstanceName gibt NDIS_STATUS_SUCCESS zurück, wenn arbeitsspeicher für die Zeichenfolge bei pAdapterInstanceName erfolgreich zugewiesen wurde; Andernfalls wird NDIS_STATUS_RESOURCES zurückgegeben.

Hinweise

Ein Protokolltreiber verwendet NdisQueryBindInstanceName , um den Anzeigenamen einer physischen NIC oder eines virtuellen Adapters abzurufen, an den der Protokolltreiber gebunden ist. Der Protokolltreiber gibt den Bindungskontext an, den NDIS im ProtocolBindAdapterEx-Funktion .

Protokolltreiber können NdisQueryBindInstanceName verwenden, um den Anzeigenamen abzurufen, bevor sie an den Adapter binden.

NdisQueryBindInstanceName weist Arbeitsspeicher für die Zeichenfolge zu, die den Anzeigenamen angibt. Nachdem der Aufrufer diesen Arbeitsspeicher verwendet hat, muss der Aufrufer die NdisFreeMemory-Funktion aufrufen, um den Arbeitsspeicher freizugeben.

Anzeigenamen sollen dem Benutzer helfen, eine physische NIC oder einen virtuellen Adapter schnell und genau zu identifizieren. Beispielsweise gelten "PCI Ethernet Adapter" und "Virtual Private Networking Adapter" als Anzeigenamen.

Anforderungen

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

Weitere Informationen

NdisFreeMemory

ProtocolBindAdapterEx

UNICODE_STRING