NDK_FN_CLOSE_OBJECT Rückruffunktion (ndkpi.h)

  • Artikel

Die Funktion NdkCloseObject (NDK_FN_CLOSE_OBJECT) initiiert eine Close-Anforderung für ein NDK-Objekt.

Syntax

NDK_FN_CLOSE_OBJECT NdkFnCloseObject;

NTSTATUS NdkFnCloseObject(
  [in]           NDK_OBJECT_HEADER *pNdkObject,
  [in]           NDK_FN_CLOSE_COMPLETION CloseCompletion,
  [in, optional] PVOID RequestContext
)
{...}

Parameter

[in] pNdkObject

Ein Zeiger auf den Objektheader (NDK_OBJECT_HEADER) für das zu schließende Objekt.

[in] CloseCompletion

Ein Zeiger auf eine NdkCloseCompletion-Rückruffunktion für schließende Vervollständigung (NDK_FN_CLOSE_COMPLETION).

[in, optional] RequestContext

Ein Kontextwert für den NDK-Anbieter, der an die NdkCloseCompletion-Funktion zurückgegeben werden soll, die im CloseCompletion-Parameter angegeben ist.

Rückgabewert

Die NdkCloseObject-Funktion gibt einen der folgenden NTSTATUS-Codes zurück.

Rückgabecode Beschreibung
STATUS_SUCCESS
 Das NDK-Objekt wird geschlossen. Der Anbieter ruft die Funktion NdkCloseCompletion nicht auf.
STATUS_PENDING
 Die Anforderung steht aus. Der Anbieter ruft die Funktion NdkCloseCompletion auf, um den Vorgang asynchron abzuschließen. Die Schließen-Anforderung wurde erfolgreich initiiert, aber möglicherweise nicht abgeschlossen.
Andere status Codes
 Ein Fehler ist aufgetreten.

Hinweise

Die Funktionsverteilungstabelle für jeden NDK-Objekttyp enthält einen NDK_FN_CLOSE_OBJECT Funktionszeiger. Schließen von Anforderungen sind asynchron. Ein NDK-Consumer darf nicht auf das Objekt zugreifen, nachdem eine Close-Anforderung gestartet wurde.

Der NDK-Anbieter muss sicherstellen, dass die NdkCloseCompletion-Funktion (NDK_FN_CLOSE_COMPLETION) der letzte Rückruf für das Objekt ist, das geschlossen wird. Der Anbieter muss sicherstellen, dass alle ausstehenden asynchronen Anforderungen abgeschlossen sind und alle laufenden Rückrufe zurückgegeben wurden und weitere Rückrufe verhindert werden, bevor der Anbieter die NdkCloseCompletion-Funktion aufruft. Nachdem der Anbieter die NdkCloseCompletion-Funktion aufgerufen hat, ruft der Anbieter keine Vervollständigungsfunktionen oder Benachrichtigungsrückruffunktionen für das Objekt auf.

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 Lebensdauer des NDKPI-Objekts

NDK_CONNECTOR_DISPATCH

NDK_CQ_DISPATCH

NDK_FN_CLOSE_COMPLETION

NDK_OBJECT_HEADER