NDK_FN_CQ_NOTIFICATION_CALLBACK Rückruffunktion (ndkpi.h)

Artikel
02/07/2025

Die NdkCqNotificationCallback- (NDK_FN_CQ_NOTIFICATION_CALLBACK) -Funktion wird vom NDK-Anbieter aufgerufen, um den Verbraucher ü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 des NdkCreateCq (NDK_FN_CREATE_CQ) -Funktion angegeben wurde, wenn das CQ-Objekt (Abschlusswarteschlange) erstellt wurde.

[in] CqStatus

Gibt den CQ-Fehlerstatus an. Die folgenden Statuscodes sind definiert:

Ausdruck	Beschreibung
STATUS_SUCCESS	Gibt an, dass das CQ normal ausgeführt wird.
STATUS_BUFFER_OVERFLOW	Gibt mehr Fertigstellungen als das Maximum an, dass das CQ in die Warteschlange im CQ eingereiht werden kann, und das CQ kann nicht verwendet werden. Alle zugeordneten Warteschlangenpaare (QPs) sind ebenfalls nicht verwendbar. Es werden keine zukünftigen Fertigstellungen gemeldet. Ein STATUS_BUFFER_OVERFLOW Fehler weist in der Regel auf einen Programmierfehler hin.
STATUS_INTERNAL_ERROR	Gibt an, dass ein schwerwiegender Fehler im CQ aufgetreten ist und das CQ nicht verwendet werden kann. Alle zugeordneten Warteschlangenpaare (QPs) sind ebenfalls nicht verwendbar. Es werden keine zukünftigen Fertigstellungen gemeldet. Ein STATUS_INTERNAL_ERROR Fehler weist in der Regel auf einen Hardwarefehler hin.

Rückgabewert

Nichts

Bemerkungen

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

Der NDK-Consumer hat die funktion NdkCqNotificationCallback im CqNotificationContext Parameter des NdkCreateCq (NDK_FN_CREATE_CQ) -Funktion angegeben, wenn das CQ-Objekt (Abschlusswarteschlange) erstellt wurde.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Keine unterstützt,in NDIS 6.30 und höher unterstützt.
mindestens unterstützte Server-	Windows Server 2012
Zielplattform-	Fenster
Header-	ndkpi.h (include Ndkpi.h)
IRQL-	<=DISPATCH_LEVEL

Siehe auch

NDKPI-Vervollständigungsanforderungen

NDK_FN_CREATE_CQ

Freigeben über