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 |
---|---|
|
NdisMSetMiniportAttributes hat die Miniportadapterattribute erfolgreich registriert. |
|
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
NDIS_MINIPORT_ADAPTER_ATTRIBUTES NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTESNDIS_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