NdisFSetAttributes-Funktion (ndis.h)
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 |
|---|---|
|
NdisFSetAttributes gibt NDIS_STATUS_SUCCESS zurück, wenn die Filtertreiberattribute festgelegt werden. |
|
Fehler bei NdisFSetAttributes aufgrund unzureichender Ressourcen. |
|
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) |