NDK_FN_CREATE_COMPLETION Rückruffunktion (ndkpi.h)

Artikel
02/07/2025

Die NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) -Funktion schließt die Erstellung eines NDK-Objekts ab.

Syntax

NDK_FN_CREATE_COMPLETION NdkFnCreateCompletion;

void NdkFnCreateCompletion(
  [in, optional] PVOID Context,
  [in]           NTSTATUS Status,
  [in]           NDK_OBJECT_HEADER *pNdkObject
)
{...}

Parameter

[in, optional] Context

Der Kontextwert, der an den NDK-Anbieter übergeben wird, wenn ein Consumer eine Objekterstellungsfunktion aufruft. Die Erstellungsfunktion stellt den Kontext mit der asynchronen Erstellungsabschlussanforderung NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) Funktionszeiger bereit.

[in] Status

Der asynchrone Abschlussstatus für die Erstellungsanforderung. Die Objekterstellungsfunktionen (z. B. NDK_FN_CREATE_CQ) finden Sie für Abschlussstatuscodes, die für jeden Objekttyp zurückgegeben werden können.

[in] pNdkObject

Ein Zeiger auf eine NDK-Objektkopfzeile (NDK_OBJECT_HEADER).

Rückgabewert

Nichts

Bemerkungen

Hinweis Diese Funktion wird vom NDK-Consumer implementiert und an den NDK-Anbieter übergeben.

NDK-Objekte werden mit asynchronen Funktionen erstellt. Diese asynchronen Objekterstellungsfunktionen verwenden einen NDK_FN_CREATE_COMPLETION Funktionszeiger als Eingabeparameter.

Ein NDK-Anbieter kann STATUS_PENDING von einer asynchronen Objekterstellungsfunktion zurückgeben. In diesem Fall muss der NDK-Anbieter die Erstellungsabschlussfunktion aufrufen, um anzugeben, dass die Objekterstellung abgeschlossen ist.

Ein anderer Statuscode gibt den Inlineabschluss an. In diesem Fall darf der Anbieter die Anforderungsabschlussfunktion nicht aufrufen. Wenn die Create-Anforderungsfunktion einen NT_STATUS Statuscode zurückgibt, der nicht STATUS_PENDING ist, muss das erstellte Objekt in einem Ausgabeparameter mit der Create-Anforderungsfunktion zurückgegeben werden.

Für Erstellungsanforderungen, die STATUS_PENDING zurückgeben und später mit STATUS_SUCCESS asynchron abgeschlossen werden, muss das erstellte Objekt von der Erstellungsabschlussfunktion mit dem pNdkObject-Parameter zurückgegeben werden, und der Anbieter darf nicht auf den Objektausgabeparameter der Create-Anforderungsfunktion zugreifen.

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