NdisMSetMiniportAttributes-Funktion (ndis.h)

Artikel
02/07/2025

Ein Miniporttreiber muss die NdisMSetMiniportAttributes- Funktion aus seiner MiniportInitializeEx--Funktion aufrufen, um einen Kontextbereich für den Miniportadapter zu NDIS zu identifizieren und NDIS mit Informationen zum Miniportadapter bereitzustellen.

Syntax

NDIS_STATUS NdisMSetMiniportAttributes(
       NDIS_HANDLE                       NdisMiniportHandle,
  [in] PNDIS_MINIPORT_ADAPTER_ATTRIBUTES MiniportAttributes
);

Parameter

NdisMiniportHandle

Der Miniportadapterziehpunkt, den NDIS an den MiniportAdapterHandle Parameter von MiniportInitializeExübergeben hat.

[in] MiniportAttributes

Ein Zeiger auf einen NDIS_MINIPORT_ADAPTER_ATTRIBUTES Vereinigung, die eine struktur mit treiberzuweisungen Attributen enthält. Die Struktur definiert die Attribute der Miniportadapterinstanz, die MiniportAdapterHandle- angibt.

Rückgabewert

NdisMSetMiniportAttributes einen der folgenden Statuswerte zurück:

Rückgabecode	Beschreibung
NDIS_STATUS_SUCCESS	NdisMSetMiniportAttributes die Miniportadapterattribute erfolgreich registriert.
NDIS_STATUS_BAD_VERSION	Gibt an, dass NDIS die version, die im Revision Member der Im Header Member in MiniportAttributes angegebenen Struktur angegeben ist, nicht unterstützt.

Bemerkungen

Ein Miniporttreiber muss NdisMSetMiniportAttributes von der MiniportInitializeEx- funktion aufrufen, bevor der Treiber andere NdisXxx--Funktion aufruft, die von den informationen abhängt, die an NdisMSetMiniportAttributesbereitgestellt werden.

Das NDIS_MINIPORT_ADAPTER_ATTRIBUTES Union ist ein Platzhalter für verschiedene Attributestrukturen. Ein Miniporttreiber ruft NdisMSetMiniportAttributes mehrfach mit unterschiedlichen Attributenstrukturen auf. Ein Miniporttreiber muss eine initialisierte NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES Struktur von MiniportInitializeEx. Der Miniport-Treiber muss diese Registrierungsattribute bereitstellen, bevor er andere NdisXxx--Funktion aufruft, die von diesen Attributen abhängt oder hardwarebasierte Ressourcen anfordert.

Der Treiber stellt einen MiniportAdapterContext Member zu NDIS in der NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES-Struktur bereit. Der MiniportAdapterContext Member identifiziert einen vom Aufrufer bereitgestellten Kontextbereich, den NDIS als Eingabeparameter an die MiniportXxx--Funktionen des Treibers übergibt. Dieser Kontextbereich enthält miniport-adapterspezifische Zustandsinformationen.

Miniporttreiber müssen die Attribute in der NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES Struktur nach dem Festlegen der Registrierungsattribute in der NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES Struktur und vor dem Festlegen zusätzlicher Attribute.

Ein Miniporttreiber kann auch NdisMSetMiniportAttributes- über die MiniportAddDevice- funktion aufrufen. In diesem Fall wird die NDIS_MINIPORT_ADD_DEVICE_REGISTRATION_ATTRIBUTES Struktur verwendet, um den Kontextbereich anzugeben.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Unterstützt in NDIS 6.0 und höher.
Zielplattform-	Universal
Header-	ndis.h (include Ndis.h)
Library	Ndis.lib
IRQL-	PASSIVE_LEVEL
DDI-Complianceregeln	Irql_Miniport_Driver_Function(ndis), NdisMRegisterIoPortRange(ndis)