NdisMQueryAdapterInstanceName-Funktion (ndis.h)

Die Funktion NdisMQueryAdapterInstanceName ruft den Anzeigenamen eines Miniportadapters ab.

Syntax

NDIS_STATUS NdisMQueryAdapterInstanceName(
  PNDIS_STRING pAdapterInstanceName,
  NDIS_HANDLE  MiniportHandle
);

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 für den angegebenen Miniportadapter an. Für Windows Vista und höhere Versionen des Windows-Betriebssystems definiert NDIS den NDIS_STRING-Typ als UNICODE_STRING Typ.

MiniportHandle

Das Handle für den Miniportadapter, der zuvor an den eingegeben wurde MiniportInitializeEx-Funktion .

Rückgabewert

Gibt NDIS_STATUS_SUCCESS zurück, wenn der Arbeitsspeicher für die Zeichenfolge bei AdapterInstanceName erfolgreich zugewiesen wurde; Andernfalls wird NDIS_STATUS_RESOURCES zurückgegeben.

Hinweise

Ein Miniporttreiber verwendet NdisMQueryAdapterInstanceName , um den Anzeigenamen einer Schnittstelle abzurufen, die der Miniporttreiber steuert. Diese Schnittstelle ist entweder eine physische NIC oder ein virtueller Adapter und wird als Miniportadapter bezeichnet. Der Miniporttreiber gibt das Handle für einen Miniportadapter in MiniportAdapterHandle an. Dieses Handle an den Miniportadapter wird an die Miniport-Treiberfunktion MiniportInitializeEx übergeben, um den Miniportadapter für Netzwerk-E/A-Vorgänge einzurichten.

NdisMQueryAdapterInstanceName 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 in NDIS 5.1 und NDIS 6.0 und höher. Informationen zu NDIS 5.1-Treibern finden Sie unter NdisMQueryAdapterInstanceName (NDIS 5.1).
Zielplattform	Universell
Header	ndis.h (einschließlich Ndis.h)
Bibliothek	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI-Complianceregeln	Irql_Miniport_Driver_Function(ndis)

Weitere Informationen

MiniportInitializeEx

NdisFreeMemory

UNICODE_STRING