NDK_FN_CREATE_CONNECTOR Rückruffunktion (ndkpi.h)

Artikel
02/26/2024

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

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-Funktion (NDK_FN_CREATE_COMPLETION), die die Erstellung eines NDK-Objekts abschließt.

[in, optional] RequestContext

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

ppNdkConnector

An diesem Speicherort wird ein Zeiger auf ein NDK-Connectorobjekt (NDK_CONNECTOR) zurückgegeben, wenn die Anforderung erfolgreich ist, ohne STATUS_PENDING zurückzugeben. Wenn NdkCreateConnector STATUS_PENDING zurückgibt, wird dieser Parameter ignoriert, und das erstellte Objekt wird mit dem Rückruf zurückgegeben, 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 ist ausstehend 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 sowohl inline als auch asynchron mit diesem status Code fehlschlagen.
Andere status Codes	Ein Fehler ist aufgetreten.

Hinweise

Die NdkCreateConnector-Funktion erstellt ein NDK-Connectorobjekt. 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 von der funktion NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) zurückgegeben, die im CreateCompletion-Parameter angegeben ist.

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_ADAPTER

NDK_ADAPTER_DISPATCH

NDK_CONNECTOR

NDK_FN_CREATE_COMPLETION

Freigeben über