NDK_FN_CLOSE_OBJECT funzione di callback (ndkpi.h)

  • Articolo

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 l'oggetto da chiudere.

[in] CloseCompletion

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

[in, optional] RequestContext

Valore di contesto per il provider NDK da restituire 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 è 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 dispatch della funzione per ogni tipo di oggetto NDK include un puntatore a 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 vengano impediti altri callback prima che il provider chiami la funzione NdkCloseCompletion . Dopo che il provider chiama la funzione NdkCloseCompletion , il provider non chiama funzioni di completamento o di callback di notifica per l'oggetto.

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_CONNECTOR_DISPATCH

NDK_CQ_DISPATCH

NDK_FN_CLOSE_COMPLETION

NDK_OBJECT_HEADER