NdisFSetAttributes-Funktion (ndis.h)

Artikel
02/07/2025

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 den Handle an den Filtertreiber in einem Aufruf der FilterAttach--Funktion übergeben.

[in] FilterModuleContext

Der vom Aufrufer zugewiesene Kontextbereich für dieses Filtermodul.

[in] FilterAttributes

Ein Zeiger auf einen zugeordneten Filtertreiber NDIS_FILTER_ATTRIBUTES Struktur.

Rückgabewert

NdisFSetAttributes gibt einen der folgenden Statuswerte zurück:

Rückgabecode	Beschreibung
NDIS_STATUS_SUCCESS	NdisFSetAttributes gibt NDIS_STATUS_SUCCESS zurück, wenn die Filtertreiberattribute festgelegt werden.
NDIS_STATUS_RESOURCES	NdisFSetAttributes aufgrund unzureichender Ressourcen fehlgeschlagen.
NDIS_STATUS_FAILURE	NdisFSetAttributes gibt NDIS_STATUS_FAILURE zurück, wenn keine der vorherigen Werte gilt.

Bemerkungen

Ein Filtertreiber ruft NdisFSetAttributes aus seiner FilterAttach- funktion auf und übergibt das Handle, das NDIS an FilterAttach an den NdisFilterHandle Parameter ü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
mindestens unterstützte Client-	Unterstützt in NDIS 6.0 und höher.
Zielplattform-	Desktop
Header-	ndis.h (include Ndis.h)
Library	Ndis.lib
IRQL-	PASSIVE_LEVEL
DDI-Complianceregeln	Irql_Filter_Driver_Function(ndis)

Siehe auch

FilterAttach-

FilterSendNetBufferLists

NDIS_FILTER_ATTRIBUTES

Freigeben über