NdisMQueryAdapterInstanceName-Funktion (ndis.h)
Die NdisMQueryAdapterInstanceName Funktion 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
Der Ziehpunkt für den Miniportadapter, der zuvor in den MiniportInitializeEx Funktion.
Rückgabewert
Gibt NDIS_STATUS_SUCCESS zurück, wenn speicher für die Zeichenfolge bei AdapterInstanceName erfolgreich zugeordnet wurde; andernfalls wird NDIS_STATUS_RESOURCES zurückgegeben.
Bemerkungen
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 Miniportadapterbezeichnet. Der Miniporttreiber gibt den Ziehpunkt für einen Miniportadapter in MiniportAdapterHandle- an. Dieser Handle an den Miniportadapter wird an die MiniportInitializeEx- Funktion des Miniporttreibers übergeben, um den Miniportadapter für Netzwerk-E/A-Vorgänge einzurichten.
NdisMQueryAdapterInstanceName reserviert Arbeitsspeicher für die Zeichenfolge, die den Anzeigenamen angibt. Nachdem der Aufrufer diesen Speicher verwendet hat, muss der Aufrufer die NdisFreeMemory--Funktion aufrufen, um den Speicher freizugeben.
Anzeigenamen sollen dem Benutzer helfen, eine physische NIC oder einen virtuellen Adapter schnell und präzise zu identifizieren, z. B. "PCI Ethernet Adapter" und "Virtual Private Networking Adapter" werden als Anzeigenamen betrachtet.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte 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- | Universal |
| Header- | ndis.h (include Ndis.h) |
| Library | Ndis.lib |
| IRQL- | PASSIVE_LEVEL |
| DDI-Complianceregeln | Irql_Miniport_Driver_Function(ndis) |