NDK_FN_CREATE_COMPLETION Rückruffunktion (ndkpi.h)

Artikel
02/29/2024

Die Funktion NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) 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 dem Funktionszeiger NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) für die asynchrone Erstellungsvervollständigung bereit.

[in] Status

Die asynchrone Vervollständigung status für die Erstellungsanforderung. Informationen zur Vervollständigung status Codes, die für jeden Objekttyp zurückgegeben werden können, finden Sie in den Objekterstellungsfunktionen (z. B. NDK_FN_CREATE_CQ).

[in] pNdkObject

Ein Zeiger auf einen NDK-Objektheader (NDK_OBJECT_HEADER).

Rückgabewert

Keine

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 aus einer asynchronen Objekterstellungsfunktion zurückgeben. In diesem Fall muss der NDK-Anbieter die Create-Vervollständigungsfunktion aufrufen, um anzugeben, dass die Objekterstellung abgeschlossen ist.

Jeder status anderen status-Code gibt die Inline-Vervollständigung an. In diesem Fall darf der Anbieter die Funktion zum Erstellen von Anforderungen nicht aufrufen. Wenn die Create Request-Funktion einen anderen NT_STATUS status Code als STATUS_PENDING zurückgibt, muss das erstellte Objekt in einem Ausgabeparameter mit der Funktion create request zurückgegeben werden.

Bei Erstellungsanforderungen, die STATUS_PENDING und später mit STATUS_SUCCESS asynchron zurückgeben, muss das erstellte Objekt von der Create-Vervollständigungsfunktion mit dem pNdkObject-Parameter zurückgegeben werden, und der Anbieter darf nicht auf den Objektausgabeparameter der Create Request-Funktion zugreifen.

Anforderungen

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