NDK_FN_CREATE_SHARED_ENDPOINT Rückruffunktion (ndkpi.h)
Die NdkCreateSharedEndpoint- (NDK_FN_CREATE_SHARED_ENDPOINT) -Funktion erstellt einen freigegebenen NDK-Endpunkt.
Syntax
NDK_FN_CREATE_SHARED_ENDPOINT NdkFnCreateSharedEndpoint;
NTSTATUS NdkFnCreateSharedEndpoint(
[in] NDK_ADAPTER *pNdkAdapter,
const PSOCKADDR pAddress,
[in] ULONG AddressLength,
[in] NDK_FN_CREATE_COMPLETION CreateCompletion,
[in, optional] PVOID RequestContext,
NDK_SHARED_ENDPOINT **ppNdkSharedEndpoint
)
{...}
Parameter
[in] pNdkAdapter
Ein Zeiger auf ein NDK-Adapterobjekt (NDK_ADAPTER).
pAddress
Eine lokale Adresse, die zum Initiieren ausgehender Verbindungen verwendet werden soll. Für AF_INET oder AF_INET6 pAddress- enthält die lokale IP-Adresse und den lokalen ND-Port.
[in] AddressLength
Die Größe der lokalen Adressdaten im pAddress-Parameter in Bytes.
[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.
ppNdkSharedEndpoint
Ein Zeiger auf ein erstelltes freigegebenes Endpunktobjekt (NDK_SHARED_ENDPOINT) wird an diesem Speicherort zurückgegeben, wenn die Anforderung erfolgreich ist, ohne STATUS_PENDING zurückzugeben. Wenn die Anforderung STATUS_PENDING zurückgibt, wird dieser Parameter ignoriert, und das erstellte Objekt wird mit dem Rückruf zurückgegeben, der im parameter CreateCompletion angegeben ist.
Rückgabewert
Die NdkCreateSharedEndpoint--Funktion gibt einen der folgenden NTSTATUS-Codes zurück.
| Rückgabecode | Beschreibung |
|---|---|
|
Das freigegebene Endpunktobjekt wurde erfolgreich erstellt und mit dem parameter "*ppNdkSharedEndpoint" *ppNdkSharedEndpoint zurückgegeben. |
|
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. |
|
Fehler bei der Anforderung aufgrund unzureichender Ressourcen.
Wichtig Die Anforderung kann inline und asynchron mit diesem Statuscode fehlschlagen.
|
|
Fehler bei der Anforderung, da die angegebene lokale Adresse bereits verwendet wird.
Wichtig Die Anforderung kann inline und asynchron mit diesem Statuscode fehlschlagen.
|
|
Fehler bei der Anforderung, da der Consumer eine lokale Portnummer von Null angegeben hat, und der Netzwerk direct-Anbieter konnte keinen Port aus dem kurzlebigen Portraum (Ports 49152-65535) zuordnen. |
|
Fehler bei der Anforderung, da die angegebene lokale Adresse keine gültige Adresse für den Adapter ist.
Wichtig Die Anforderung kann inline und asynchron mit diesem Statuscode fehlschlagen.
|
|
Fehler. |
Bemerkungen
Die funktion NdkCreateSharedEndpoint erstellt einen gemeinsam genutzten NDK-Endpunkt, der als lokale Adresse für mehrere ausgehende Verbindungen verwendet wird, die für verschiedene Remoteadressen bestimmt sind. Dies entspricht mehreren eingehenden Verbindungen mit derselben lokalen Adresse, die durch ein Listenerobjekt dargestellt wird.
Wenn die Funktion STATUS_SUCCESS zurückgibt, wird das erstellte Objekt im ppNdkSharedEndpoint Parameter zurückgegeben. Wenn NdkCreateSharedEndpoint- STATUS_PENDING zurückgibt, wird das erstellte Objekt von der 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