NDK_FN_CQ_NOTIFICATION_CALLBACK fonction de rappel (ndkpi.h)

Article
02/07/2025

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 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 l’état de l’erreur CQ. Les codes d’état suivants sont définis :

Terme	Description
STATUS_SUCCESS	Indique que le CQ fonctionne normalement.
STATUS_BUFFER_OVERFLOW	Indique plus d’achèvements que ce maximum que le CQ peut contenir a été tenté d’être mis en file d’attente sur le CQ et que le CQ est inutilisable. Toutes les paires de files d’attente associées sont également inutilisables. Aucune fin ultérieure n’est signalée. 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 la CQ est inutilisable. Toutes les paires de files d’attente associées sont également inutilisables. Aucune fin ultérieure n’est signalée. Une erreur STATUS_INTERNAL_ERROR indique généralement une erreur matérielle.

Valeur de retour

Aucun

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).

Exigences

Exigence	Valeur
client minimum pris en charge	Aucune prise en charge, prise en charge dans NDIS 6.30 et versions ultérieures.
serveur minimum pris en charge	Windows Server 2012
plateforme cible	Windows
d’en-tête	ndkpi.h (include Ndkpi.h)
IRQL	<=DISPATCH_LEVEL

Voir aussi

exigences de gestion de la saisie semi-automatique NDKPI

NDK_FN_CREATE_CQ

Partager via