NDK_FN_CLOSE_OBJECT Rückruffunktion (ndkpi.h)
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 |
|---|---|
|
Das NDK-Objekt wird geschlossen. Der Anbieter ruft die Funktion NdkCloseCompletion nicht auf. |
|
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. |
|
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 |