NdisQueryAdapterInstanceName-Funktion (ndis.h)
Die NdisQueryAdapterInstanceName Funktion ruft den Anzeigenamen einer physischen NIC oder eines virtuellen Adapters ab, an den 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 sich die Bindung bezieht. 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 NIC oder den virtuellen Adapter des nächsten unteren Treibers identifiziert, an den der Aufrufer gebunden ist. In der Regel wurde NdisBindingHandle- von der funktion NdisOpenAdapterEx zurückgegeben.
Rückgabewert
NdisQueryAdapterInstanceName gibt NDIS_STATUS_SUCCESS zurück, wenn der Speicher für die Zeichenfolge bei AdapterInstanceName erfolgreich zugeordnet wurde; andernfalls wird NDIS_STATUS_RESOURCES zurückgegeben.
Bemerkungen
Ein Protokolltreiber verwendet NdisQueryAdapterInstanceName, um den Anzeigenamen einer physischen NIC 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 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 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 |
| Header- | ndis.h (include Ndis.h) |
| Library | Ndis.lib |
| IRQL- | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | Irql_Miscellaneous_Function(ndis) |