NDK_FN_CQ_NOTIFICATION_CALLBACK fonction de rappel (ndkpi.h)

Article
02/29/2024

La fonction NdkCqNotificationCallback (NDK_FN_CQ_NOTIFICATION_CALLBACK) est appelée par le fournisseur NDK pour informer le consommateur d’un événement de file d’attente d’achèvement (CQ).

Syntaxe

NDK_FN_CQ_NOTIFICATION_CALLBACK NdkFnCqNotificationCallback;

void NdkFnCqNotificationCallback(
  [in, optional] PVOID CqNotificationContext,
  [in]           NTSTATUS CqStatus
)
{...}

Paramètres

[in, optional] CqNotificationContext

Zone de contexte qui a été spécifiée dans le paramètre CqNotificationContext de la fonction NdkCreateCq (NDK_FN_CREATE_CQ) lors de la création de l’objet de file d’attente d’achèvement (CQ).

[in] CqStatus

Indique le status d’erreur CQ. Les codes status suivants sont définis :

Terme	Description
STATUS_SUCCESS	Indique que le CQ fonctionne normalement.
STATUS_BUFFER_OVERFLOW	Indique que plus d’achèvements que le maximum que le CQ peut contenir ont été tentés d’être mis en file d’attente sur le CQ et le CQ est inutilisable. Toutes les paires de files d’attente (QP) associées sont également inutilisables. Aucun achèvement ultérieur ne sera signalé. Une erreur STATUS_BUFFER_OVERFLOW indique généralement une erreur de programmation.
STATUS_INTERNAL_ERROR	Indique qu’une erreur irrécupérable s’est produite sur le CQ et que le CQ est inutilisable. Toutes les paires de files d’attente (QP) associées sont également inutilisables. Aucun achèvement ultérieur ne sera signalé. Une erreur STATUS_INTERNAL_ERROR indique généralement une erreur matérielle.

Valeur de retour

None

Remarques

Un fournisseur NDK appelle NdkCqNotificationCallback pour informer le consommateur d’un événement de file d’attente d’achèvement (CQ).

Le consommateur NDK a spécifié la fonction NdkCqNotificationCallback dans le paramètre CqNotificationContext de la fonction NdkCreateCq (NDK_FN_CREATE_CQ) lors de la création de l’objet de file d’attente d’achèvement (CQ).

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

Voir aussi

Exigences de gestion de la saisie semi-automatique NDKPI

NDK_FN_CREATE_CQ

Partager via