NdisFSetAttributes-Funktion (ndis.h)

Artikel
08/07/2023

Ein Filtertreiber ruft die NdisFSetAttributes-Funktion auf, um einen Filtermodulkontextbereich anzugeben.

Syntax

NDIS_STATUS NdisFSetAttributes(
  [in] NDIS_HANDLE                  NdisFilterHandle,
  [in] __drv_aliasesMem NDIS_HANDLE FilterModuleContext,
  [in] PNDIS_FILTER_ATTRIBUTES      FilterAttributes
);

Parameter

[in] NdisFilterHandle

Das NDIS-Handle, das dieses Filtermodul identifiziert. NDIS hat das Handle in einem Aufruf der FilterAttach-Funktion an den Filtertreiber übergeben.

[in] FilterModuleContext

Der vom Aufrufer zugeordnete Kontextbereich für dieses Filtermodul.

[in] FilterAttributes

Ein Zeiger auf einen zugeordneten Filtertreiber NDIS_FILTER_ATTRIBUTES Struktur.

Rückgabewert

NdisFSetAttributes gibt einen der folgenden status Werte zurück:

Rückgabecode	Beschreibung
NDIS_STATUS_SUCCESS	NdisFSetAttributes gibt NDIS_STATUS_SUCCESS zurück, wenn die Filtertreiberattribute festgelegt werden.
NDIS_STATUS_RESOURCES	Fehler bei NdisFSetAttributes aufgrund unzureichender Ressourcen.
NDIS_STATUS_FAILURE	NdisFSetAttributes gibt NDIS_STATUS_FAILURE zurück, wenn keiner der vorherigen Werte zutrifft.

Hinweise

Ein Filtertreiber ruft NdisFSetAttributes über seine FilterAttach-Funktion auf und übergibt das Handle, das NDIS am Parameter NdisFilterHandle an FilterAttach übergeben hat. Der FilterModuleContext-Parameter von NdisFSetAttributes gibt den Kontextbereich für dieses Filtermodul an. NDIS übergibt den Kontextbereich zurück an den Filtertreiber in Aufrufen von Funktionen wie FilterSendNetBufferLists.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt in NDIS 6.0 und höher.
Zielplattform	Desktop
Kopfzeile	ndis.h (include Ndis.h)
Bibliothek	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI-Complianceregeln	Irql_Filter_Driver_Function(ndis)

Weitere Informationen

FilterAttach

FilterSendNetBufferLists

NDIS_FILTER_ATTRIBUTES

Share via