NDK_FN_RESIZE_CQ Rückruffunktion (ndkpi.h)

  • Artikel

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