NDK_FN_MODIFY_SRQ Rückruffunktion (ndkpi.h)

Artikel
02/07/2025

Die NdkModifySrq- (NDK_FN_MODIFY_SRQ) ändert den Größen- und Benachrichtigungsschwellenwert einer NDK-Empfangenwarteschlange (SRQ).

Syntax

NDK_FN_MODIFY_SRQ NdkFnModifySrq;

NTSTATUS NdkFnModifySrq(
  [in]           NDK_SRQ *pNdkSrq,
  [in]           ULONG SrqDepth,
  [in]           ULONG NotifyThreshold,
  [in]           NDK_FN_REQUEST_COMPLETION RequestCompletion,
  [in, optional] PVOID RequestContext
)
{...}

Parameter

[in] pNdkSrq

Ein Zeiger auf ein NDK shared receive queue (SRQ)-Objekt (NDK_SRQ).

[in] SrqDepth

Die neue Größe des SRQ. Die neue Größe muss kleiner oder gleich der Größe sein, die im MaxSrqDepth- Element der NDK_ADAPTER_INFO-Struktur angegeben ist. Eine Größe von Null bedeutet, dass keine Tiefenänderung angefordert wird. Das heißt, der vorhandene SRQ-Tiefenwert muss beibehalten werden.

[in] NotifyThreshold

Die Anzahl der in die Warteschlange eingereihten Empfangsanforderungen, die einen SRQ-Benachrichtigungsrückruf auslösen. Wenn dieser Wert größer als 0 ist, muss der NDK-Anbieter die SRQ-Benachrichtigung armieren, um auszulösen, wenn die Anzahl der in die Warteschlange eingereihten Empfangsanforderungen unter den angegebenen Wert fällt. Wenn die Anzahl der in die Warteschlange eingereihten Empfangsanforderungen zum Zeitpunkt dieses Funktionsaufrufs bereits unter dem Schwellenwert liegt, muss eine SRQ-Benachrichtigung generiert werden. Nachdem eine SRQ-Benachrichtigung generiert wurde, werden weitere Benachrichtigungen entwaffnet, bis der NDK-Consumer diese Funktion erneut mit einem Schwellenwert ohne Null aufruft. Wenn ein Schwellenwert von Null angegeben wird, muss der Anbieter den aktuellen SRQ-Benachrichtigungsschwellenwert und den Armingstatus beibehalten.

[in] RequestCompletion

Ein Zeiger auf eine Anforderungsabschlussrückrufroutine NdkRequestCompletion (NDK_FN_REQUEST_COMPLETION).

[in, optional] RequestContext

Ein Kontextwert, der an den parameter Context der Rückruffunktion übergeben werden soll, die im RequestCompletion Parameter angegeben ist.

Rückgabewert

Die funktion NdkModifySrq gibt einen der folgenden NTSTATUS-Codes zurück.

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Anforderung wurde erfolgreich abgeschlossen.
STATUS_PENDING	Der Vorgang steht aus und wird später abgeschlossen. Der Treiber ruft die angegebene RequestCompletion (NDK_FN_REQUEST_COMPLETION) -Funktion auf, um den ausstehenden Vorgang abzuschließen.
STATUS_INVALID_PARAMETER	Fehler bei der Anforderung, da der Wert im SrqDepth- Parameter nicht innerhalb der Grenzwerte liegt, die in der NDK_ADAPTER_INFO-Struktur angegeben sind.
Andere Statuscodes	Fehler.

Bemerkungen

NdkModifySrq ändert den Größen- und Benachrichtigungsschwellenwert für ein SRQ-Objekt (NDK Shared Receive Queue) (NDK_SRQ).

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Keine unterstützt,in NDIS 6.30 und höher unterstützt.
mindestens unterstützte Server-	Windows Server 2012
Zielplattform-	Fenster
Header-	ndkpi.h (include Ndkpi.h)
IRQL-	<=DISPATCH_LEVEL

Siehe auch

anforderungen für NDKPI-Objektlebensdauer

NDK_ADAPTER_INFO

NDK_FN_REQUEST_COMPLETION

NDK_SRQ

Freigeben über