NdisMSetMiniportAttributes-Funktion (ndis.h)

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)

Weitere Informationen

Initialisieren eines Miniportadapters

MiniportInitializeEx

NDIS_MINIPORT_ADAPTER_ATTRIBUTES NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES

NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES

NDIS_MINIPORT_ADAPTER_NDK_ATTRIBUTES

NDIS_MINIPORT_ADAPTER_OFFLOAD_ATTRIBUTES

NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES

NDIS_MINIPORT_ADD_DEVICE_REGISTRATION_ATTRIBUTES

Festlegen der NDIS 6.0-Miniportadapterattribute