NDK_FN_RESIZE_CQ fonction de rappel (ndkpi.h)

Article
03/01/2024

La fonction NdkResizeCq (NDK_FN_RESIZE_CQ) modifie la taille d’une file d’attente de saisie semi-automatique (CQ).

Syntaxe

NDK_FN_RESIZE_CQ NdkFnResizeCq;

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

Paramètres

[in] pNdkCq

Pointeur vers un objet de file d’attente d’achèvement (CQ) NDK (NDK_CQ).

[in] CqDepth

Nouveau nombre d’entrées de saisie semi-automatique que le CQ peut contenir. La taille CQ doit être inférieure ou égale à la valeur spécifiée dans le membre MaxCqDepth de la structure NDK_ADAPTER_INFO .

[in] RequestCompletion

Pointeur vers une fonction NdkRequestCompletion (NDK_FN_REQUEST_COMPLETION).

[in, optional] RequestContext

Valeur de contexte à passer au paramètre Context de la fonction de rappel spécifiée dans le paramètre RequestCompletion .

Valeur retournée

La fonction NDK_FN_RESIZE_CQ retourne l’un des codes NTSTATUS suivants.

Code de retour	Description
STATUS_SUCCESS	Le CQ a été redimensionné avec succès.
STATUS_PENDING	L’opération est en attente et sera terminée ultérieurement. Le pilote appelle la fonction RequestCompletion (NDK_FN_REQUEST_COMPLETION) spécifiée pour terminer l’opération en attente.
STATUS_INVALID_PARAMETER	La demande a échoué, car la taille CQ spécifiée dans le paramètre CqDepth est supérieure à la valeur du membre MaxCqDepth dans la structure NDK_ADAPTER_INFO .
STATUS_INSUFFICIENT_RESOURCES	La demande a échoué en raison de ressources insuffisantes. Important La requête peut échouer en ligne et de manière asynchrone avec ce code status.
Autres codes status	Une erreur est survenue.

Remarques

NdkResizeCq modifie le nombre d’entrées d’achèvement qu’un CQ peut contenir.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucune prise en charge, prise en charge dans NDIS 6.30 et versions ultérieures.
Serveur minimal pris en charge	Windows Server 2012
Plateforme cible	Windows
En-tête	ndkpi.h (incluez Ndkpi.h)
IRQL	<=DISPATCH_LEVEL