NDK_FN_CLOSE_OBJECT funzione di callback (ndkpi.h)

La funzione NdkCloseObject (NDK_FN_CLOSE_OBJECT) avvia una richiesta di chiusura per un oggetto NDK.

Sintassi

NDK_FN_CLOSE_OBJECT NdkFnCloseObject;

NTSTATUS NdkFnCloseObject(
  [in]           NDK_OBJECT_HEADER *pNdkObject,
  [in]           NDK_FN_CLOSE_COMPLETION CloseCompletion,
  [in, optional] PVOID RequestContext
)
{...}

Parametri

[in] pNdkObject

Puntatore all'intestazione dell'oggetto (NDK_OBJECT_HEADER) per chiudere l'oggetto.

[in] CloseCompletion

Puntatore a una funzione di callback di completamento di NdkCloseCompletion (NDK_FN_CLOSE_COMPLETION).

[in, optional] RequestContext

Valore di contesto per il provider NDK da passare alla funzione NdkCloseCompletion specificata nel parametro CloseCompletion .

Valore restituito

La funzione NdkCloseObject restituisce uno dei codici NTSTATUS seguenti.

Codice restituito Descrizione
STATUS_SUCCESS
L'oggetto NDK viene chiuso. Il provider non chiamerà la funzione NdkCloseCompletion .
STATUS_PENDING
La richiesta è in sospeso, il provider chiamerà la funzione NdkCloseCompletion per completare l'operazione in modo asincrono. La richiesta di chiusura è stata avviata correttamente, ma potrebbe non essere completata.
Altri codici di stato
Si è verificato un errore.

Commenti

La tabella di invio delle funzioni per ogni tipo di oggetto NDK include un puntatore alla funzione NDK_FN_CLOSE_OBJECT . Le richieste di chiusura sono asincrone. Un consumer NDK non deve accedere all'oggetto dopo l'avvio di una richiesta di chiusura.

Il provider NDK deve assicurarsi che la funzione NdkCloseCompletion (NDK_FN_CLOSE_COMPLETION) sia l'ultimo callback chiamato per l'oggetto che sta chiudendo. Il provider deve assicurarsi che tutte le richieste asincrone in sospeso vengano completate e che tutti i callback in corso siano stati restituiti e altri callback vengano impediti prima che il provider chiami la funzione NdkCloseCompletion . Dopo che il provider chiama la funzione NdkCloseCompletion , il provider non chiama funzioni di completamento o callback di notifica per l'oggetto.

Requisiti

   
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

Vedi anche

Requisiti di durata dell'oggetto ND KPI

NDK_CONNECTOR_DISPATCH

NDK_CQ_DISPATCH

NDK_FN_CLOSE_COMPLETION

NDK_OBJECT_HEADER