NDK_FN_LISTEN funzione di callback (ndkpi.h)

  • Articolo

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