NDK_FN_MODIFY_SRQ Rückruffunktion (ndkpi.h)

  • Artikel

Die Funktion NdkModifySrq (NDK_FN_MODIFY_SRQ) ändert die Größe und den Benachrichtigungsschwellenwert einer NDK-Warteschlange für freigegebenen Empfang (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 SRQ-Objekt (NDK Shared Receive Queue) (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 0 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 (null) ist, muss der NDK-Anbieter die SRQ-Benachrichtigung so ausrüsten, dass sie ausgelöst wird, 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 aufgehoben, bis der NDK-Consumer diese Funktion erneut mit einem Schwellenwert von ungleich 0 aufruft. Wenn ein Schwellenwert von 0 (null) angegeben wird, muss der Anbieter den aktuellen SRQ-Benachrichtigungsschwellenwert beibehalten und status.

[in] RequestCompletion

Ein Zeiger auf die Rückrufroutine NdkRequestCompletion (NDK_FN_REQUEST_COMPLETION) der Anforderungsvervollständigung.

[in, optional] RequestContext

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

Rückgabewert

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

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

Hinweise

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Keine unterstützt, unterstützt in NDIS 6.30 und höher.
Unterstützte Mindestversion (Server) Windows Server 2012
Zielplattform Windows
Kopfzeile ndkpi.h (Ndkpi.h einschließen)
IRQL <=DISPATCH_LEVEL

Weitere Informationen

Anforderungen an die Lebensdauer des NDKPI-Objekts

NDK_ADAPTER_INFO

NDK_FN_REQUEST_COMPLETION

NDK_SRQ