NDK_FN_CREATE_LISTENER funzione di callback (ndkpi.h)

Articolo
03/05/2024

La funzione NdkCreateListener (NDK_FN_CREATE_LISTENER) crea un oggetto listener NDK.

Sintassi

NDK_FN_CREATE_LISTENER NdkFnCreateListener;

NTSTATUS NdkFnCreateListener(
  [in]           NDK_ADAPTER *pNdkAdapter,
  [in]           NDK_FN_CONNECT_EVENT_CALLBACK ConnectEvent,
  [in, optional] PVOID ConnectEventContext,
  [in]           NDK_FN_CREATE_COMPLETION CreateCompletion,
  [in, optional] PVOID RequestContext,
                 NDK_LISTENER **ppNdkListener
)
{...}

Parametri

[in] pNdkAdapter

Puntatore a un oggetto adattatore NDK (NDK_ADAPTER).

[in] ConnectEvent

Puntatore alla funzione NdkConnectEventCallback (NDK_FN_CONNECT_EVENT_CALLBACK) usata dal provider per notificare al consumer ogni richiesta di connessione in ingresso.

[in, optional] ConnectEventContext

Valore di contesto passato al provider NDK alla funzione NdkConnectEventCallback specificata nel parametro ConnectEvent .

[in] CreateCompletion

Puntatore a una funzione NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) che completa la creazione di un oggetto NDK.

[in, optional] RequestContext

Valore di contesto passato al provider NDK alla funzione NdkCreateCompletion specificata nel parametro CreateCompletion .

ppNdkListener

Un puntatore all'oggetto listener NDK creato (NDK_LISTENER) viene restituito in questa posizione se la richiesta ha esito positivo senza restituire STATUS_PENDING. Se NdkCreateListener restituisce STATUS_PENDING questo parametro viene ignorato e l'oggetto creato viene restituito con il callback specificato nel parametro CreateCompletion .

Valore restituito

La funzione NdkCreateListener restituisce uno dei codici NTSTATUS seguenti.

Codice restituito	Descrizione
STATUS_SUCCESS	L'oggetto listener è stato creato correttamente e restituito con il parametro *ppNdkListener .
STATUS_PENDING	L'operazione è in sospeso e verrà completata in un secondo momento. Il provider chiamerà la funzione specificata nel parametro CreateCompletion (NDK_FN_CREATE_COMPLETION) 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.
Altri codici di stato	Si è verificato un errore.

Commenti

La funzione NdkCreateListener crea un oggetto listener NDK. Se la funzione restituisce STATUS_SUCCESS, l'oggetto creato viene restituito nel parametro ppNdkListener . Se NdkCreateListener restituisce STATUS_PENDING, l'oggetto creato viene restituito dalla funzione NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) specificata nel parametro CreateCompletion .

Requisiti

Requisito	Valore
Client minimo supportato	Nessuna supportata, supportata in NDIS 6.30 e versioni successive.
Server minimo supportato	Windows Server 2012
Piattaforma di destinazione	Windows
Intestazione	ndkpi.h (include Ndkpi.h)
IRQL	<=DISPATCH_LEVEL