NDK_FN_MODIFY_SRQ Rückruffunktion (ndkpi.h)
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 |
|---|---|
|
Die Anforderung wurde erfolgreich abgeschlossen. |
|
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. |
|
Die Anforderung ist fehlgeschlagen, weil der Wert im SrqDepth-Parameter nicht innerhalb der Grenzwerte liegt, die in der NDK_ADAPTER_INFO-Struktur angegeben sind. |
|
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 |