NDK_FN_LISTEN funzione di callback (ndkpi.h)

Articolo
02/29/2024

La funzione NdkListen (NDK_FN_LISTEN) inserisce un oggetto listener NDK in modalità di ascolto.

Sintassi

NDK_FN_LISTEN NdkFnListen;

NTSTATUS NdkFnListen(
  [in]           NDK_LISTENER *pNdkListener,
                 const PSOCKADDR pAddress,
  [in]           ULONG AddressLength,
  [in]           NDK_FN_REQUEST_COMPLETION RequestCompletion,
  [in, optional] PVOID RequestContext
)
{...}

Parametri

[in] pNdkListener

Puntatore a un oggetto listener NDK (NDK_LISTENER).

pAddress

Indirizzo locale su cui restare in ascolto. Per AF_INET o AF_INET6 pAddress contiene l'indirizzo IP locale e la porta ND locale.

[in] AddressLength

Dimensione, in byte, dei dati dell'indirizzo locale nel parametro pAddress .

[in] RequestCompletion

Puntatore a una routine di callback di completamento della richiesta NdkRequestCompletion (NDK_FN_REQUEST_COMPLETION).

[in, optional] RequestContext

Valore di contesto da passare al parametro Context della funzione di callback specificata nel parametro RequestCompletion .

Valore restituito

La funzione NdkListen restituisce uno dei codici NTSTATUS seguenti.

Codice restituito	Descrizione
STATUS_SUCCESS	La richiesta di ascolto ha avuto esito positivo.
STATUS_PENDING	L'operazione è in sospeso e verrà completata in un secondo momento. Il driver chiamerà la funzione RequestCompletion (NDK_FN_REQUEST_COMPLETION) specificata per completare l'operazione in sospeso.
STATUS_INSUFFICIENT_RESOURCES	La richiesta non è riuscita a causa di risorse insufficienti. Importante La richiesta può non riuscire inline e in modo asincrono con questo codice di stato.
STATUS_SHARING_VIOLATION	La richiesta non è riuscita perché l'indirizzo locale specificato è già in uso. Importante La richiesta può non riuscire inline e in modo asincrono con questo codice di stato.
STATUS_INVALID_ADDRESS	La richiesta non è riuscita perché l'indirizzo locale specificato non è un indirizzo valido per l'adapter. Importante La richiesta può non riuscire inline e in modo asincrono con questo codice di stato.
STATUS_TOO_MANY_ADDRESSES	La richiesta non è riuscita perché il consumer ha specificato un numero di porta locale pari a zero e il provider Network Direct non è riuscito ad allocare una porta dallo spazio delle porte temporanee (porte 49152-65535).
Altri codici di stato	Si è verificato un errore.

Commenti

NdkListen inserisce un oggetto listener in modalità di ascolto sull'indirizzo locale specificato.

Requisiti

Requisito	Valore
Client minimo supportato	None supported,Supported in NDIS 6.30 and later.
Server minimo supportato	Windows Server 2012
Piattaforma di destinazione	Windows
Intestazione	ndkpi.h (include Ndkpi.h)
IRQL	<=DISPATCH_LEVEL

Vedi anche

Requisiti di durata dell'oggetto NDKPI

NDK_FN_REQUEST_COMPLETION

NDK_LISTENER

Condividi tramite