NdisMSetMiniportAttributes-Funktion (ndis.h)

Artikel
08/07/2023

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

Syntax

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

Parameter

NdisMiniportHandle

Das Miniportadapterhandle, das NDIS an den MiniportAdapterHandle-Parameter von MiniportInitializeEx übergeben hat.

[in] MiniportAttributes

Ein Zeiger auf einen NDIS_MINIPORT_ADAPTER_ATTRIBUTES Union, die eine vom Treiber zugewiesene Attributstruktur enthält. Die Struktur definiert die Attribute des Miniportadapters instance, den MiniportAdapterHandle angibt.

Rückgabewert

NdisMSetMiniportAttributes gibt einen der folgenden status Werte zurück:

Rückgabecode	Beschreibung
NDIS_STATUS_SUCCESS	NdisMSetMiniportAttributes hat die Miniportadapterattribute erfolgreich registriert.
NDIS_STATUS_BAD_VERSION	Gibt an, dass NDIS die Version nicht unterstützt, die im Revision-Member der Struktur angegeben ist, die im Header-Member unter MiniportAttributes angegeben ist.

Hinweise

Ein Miniporttreiber muss NdisMSetMiniportAttributes über seine MiniportInitializeEx-Funktion aufrufen, bevor der Treiber eine andere NdisXxx-Funktion aufruft, die von den für NdisMSetMiniportAttributes bereitgestellten Informationen abhängt.

The NDIS_MINIPORT_ADAPTER_ATTRIBUTES Union ist ein Platzhalter für verschiedene Attributstrukturen. Ein Miniporttreiber ruft NdisMSetMiniportAttributes mehrmals mit unterschiedlichen Attributstrukturen auf. Ein Miniporttreiber muss eine initialisierte NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES Struktur von MiniportInitializeEx. Der Miniporttreiber muss diese Registrierungsattribute bereitstellen, bevor er eine andere NdisXxx-Funktion aufruft, die von diesen Attributen abhängt oder Hardwareressourcen beansprucht.

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

Miniporttreiber müssen die Attribute im 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 seine MiniportAddDevice-Funktion aufrufen. In diesem Fall wird die NDIS_MINIPORT_ADD_DEVICE_REGISTRATION_ATTRIBUTES-Struktur verwendet, um den Kontextbereich anzugeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt in NDIS 6.0 und höher.
Zielplattform	Universell
Header	ndis.h (einschließlich Ndis.h)
Bibliothek	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI-Complianceregeln	Irql_Miniport_Driver_Function(ndis), NdisMRegisterIoPortRange(ndis)