NDK_FN_CQ_NOTIFICATION_CALLBACK Rückruffunktion (ndkpi.h)

Artikel
03/01/2024

Die Funktion NdkCqNotificationCallback (NDK_FN_CQ_NOTIFICATION_CALLBACK) wird vom NDK-Anbieter aufgerufen, um den Consumer über ein CQ-Ereignis (Completion Queue) zu benachrichtigen.

Syntax

NDK_FN_CQ_NOTIFICATION_CALLBACK NdkFnCqNotificationCallback;

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

Parameter

[in, optional] CqNotificationContext

Ein Kontextbereich, der im CqNotificationContext-Parameter der NdkCreateCq-Funktion (NDK_FN_CREATE_CQ) angegeben wurde, als das CQ-Objekt (Completion Queue) erstellt wurde.

[in] CqStatus

Gibt den CQ-Fehler status an. Die folgenden status Codes sind definiert:

Begriff	BESCHREIBUNG
STATUS_SUCCESS	Gibt an, dass das CQ normal funktioniert.
STATUS_BUFFER_OVERFLOW	Gibt an, dass mehr Vervollständigungen als das Maximum, das der CQ enthalten kann, für den CQ in die Warteschlange eingereiht werden soll, und der CQ ist nicht verwendbar. Alle zugeordneten Warteschlangenpaare (QPs) sind ebenfalls unbrauchbar. Zukünftige Vervollständigungen werden nicht gemeldet. Ein STATUS_BUFFER_OVERFLOW Fehler weist in der Regel auf einen Programmierfehler hin.
STATUS_INTERNAL_ERROR	Gibt an, dass im CQ ein schwerwiegender Fehler aufgetreten ist und der CQ nicht verwendet werden kann. Alle zugeordneten Warteschlangenpaare (QPs) sind ebenfalls unbrauchbar. Zukünftige Vervollständigungen werden nicht gemeldet. Ein STATUS_INTERNAL_ERROR Fehler weist in der Regel auf einen Hardwarefehler hin.

Rückgabewert

Keine

Bemerkungen

Ein NDK-Anbieter ruft NdkCqNotificationCallback auf, um den Consumer über ein CQ-Ereignis (Completion Queue) zu benachrichtigen.

Der NDK-Consumer hat die NdkCqNotificationCallback-Funktion im CqNotificationContext-Parameter der NdkCreateCq-Funktion (NDK_FN_CREATE_CQ) angegeben, als das CQ-Objekt (Completion Queue) erstellt wurde.

Anforderungen

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

Weitere Informationen

Anforderungen an die NDKPI-Vervollständigung

NDK_FN_CREATE_CQ

Freigeben über