NDK_FN_CREATE_CONNECTOR Rückruffunktion (ndkpi.h)

Artikel
02/07/2025

Die NdkCreateConnector- (NDK_FN_CREATE_CONNECTOR) -Funktion erstellt ein NDK-Verbinderobjekt.

Syntax

NDK_FN_CREATE_CONNECTOR NdkFnCreateConnector;

NTSTATUS NdkFnCreateConnector(
  [in]           NDK_ADAPTER *pNdkAdapter,
  [in]           NDK_FN_CREATE_COMPLETION CreateCompletion,
  [in, optional] PVOID RequestContext,
                 NDK_CONNECTOR **ppNdkConnector
)
{...}

Parameter

[in] pNdkAdapter

Ein Zeiger auf ein NDK-Adapterobjekt (NDK_ADAPTER).

[in] CreateCompletion

Ein Zeiger auf eine NdkCreateCompletion- (NDK_FN_CREATE_COMPLETION) -Funktion, die die Erstellung eines NDK-Objekts abschließt.

[in, optional] RequestContext

Ein Kontextwert, den der NDK-Anbieter an die NdkCreateCompletion--Funktion übergibt, die im CreateCompletion-Parameter angegeben ist.

ppNdkConnector

Ein Zeiger auf ein NDK-Verbinderobjekt (NDK_CONNECTOR) wird an dieser Stelle zurückgegeben, wenn die Anforderung erfolgreich ist, ohne STATUS_PENDING zurückzugeben. Wenn NdkCreateConnector zurückgibt, STATUS_PENDING dieser Parameter ignoriert wird und das erstellte Objekt mit dem Rückruf zurückgegeben wird, der im CreateCompletion Parameter angegeben ist.

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_SUCCESS	Der Connector wurde erfolgreich erstellt und mit dem parameter *ppNdkConnector zurückgegeben.
STATUS_PENDING	Der Vorgang steht aus und wird später abgeschlossen. Der Anbieter ruft die im CreateCompletion Parameter(NDK_FN_CREATE_COMPLETION) angegebene Funktion auf, um den ausstehenden Vorgang abzuschließen.
STATUS_INSUFFICIENT_RESOURCES	Fehler bei der Anforderung aufgrund unzureichender Ressourcen. Wichtig Die Anforderung kann inline und asynchron mit diesem Statuscode fehlschlagen.
Andere Statuscodes	Fehler.

Bemerkungen

Die NdkCreateConnector--Funktion erstellt ein NDK-Verbinderobjekt. Wenn die Funktion STATUS_SUCCESS zurückgibt, wird das erstellte Objekt im ppNdkConnector Parameter zurückgegeben. Wenn NdkCreateConnector STATUS_PENDING zurückgibt, wird das erstellte Objekt vom NdkCreateCompletion- (NDK_FN_CREATE_COMPLETION) -Funktion zurückgegeben, die im CreateCompletion--Parameter angegeben ist.

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

anforderungen für NDKPI-Objektlebensdauer

NDK_ADAPTER

NDK_ADAPTER_DISPATCH

NDK_CONNECTOR

NDK_FN_CREATE_COMPLETION

Freigeben über