NDK_FN_CREATE_CONNECTOR Rückruffunktion (ndkpi.h)

  • Artikel

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