NDK_FN_RESIZE_CQ Rückruffunktion (ndkpi.h)

Artikel
02/26/2024

Die Funktion NdkResizeCq (NDK_FN_RESIZE_CQ) ändert die Größe einer NDK-Vervollständigungswarteschlange (CQ).

Syntax

NDK_FN_RESIZE_CQ NdkFnResizeCq;

NTSTATUS NdkFnResizeCq(
  [in]           NDK_CQ *pNdkCq,
  [in]           ULONG CqDepth,
  [in]           NDK_FN_REQUEST_COMPLETION RequestCompletion,
  [in, optional] PVOID RequestContext
)
{...}

Parameter

[in] pNdkCq

Ein Zeiger auf ein CQ-Objekt (NDK-Vervollständigungswarteschlange) (NDK_CQ).

[in] CqDepth

Die neue Anzahl von Vervollständigungseinträgen, die der CQ enthalten kann. Die CQ-Größe muss kleiner oder gleich dem Wert sein, der im MaxCqDepth-Element in der NDK_ADAPTER_INFO-Struktur angegeben ist.

[in] RequestCompletion

Ein Zeiger auf eine NdkRequestCompletion-Funktion (NDK_FN_REQUEST_COMPLETION).

[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 NDK_FN_RESIZE_CQ-Funktion gibt einen der folgenden NTSTATUS-Codes zurück.

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Größe des CQ wurde erfolgreich geändert.
STATUS_PENDING	Der Vorgang steht aus 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, da die im CqDepth-Parameter angegebene CQ-Größe größer als der Wert im MaxCqDepth-Member in der NDK_ADAPTER_INFO-Struktur ist.
STATUS_INSUFFICIENT_RESOURCES	Fehler bei der Anforderung aufgrund unzureichender Ressourcen. Wichtig Die Anforderung kann sowohl inline als auch asynchron mit diesem status Code fehlschlagen.
Andere status Codes	Ein Fehler ist aufgetreten.

Hinweise

NdkResizeCq ändert die Anzahl der Vervollständigungseinträge, die ein CQ enthalten kann.

Anforderungen

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

Weitere Informationen

Anforderungen an die Lebensdauer des NDKPI-Objekts

NDK_ADAPTER_INFO

NDK_CQ

NDK_CQ_DISPATCH

NDK_FN_REQUEST_COMPLETION

Freigeben über