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 l'oggetto da chiudere.
[in] CloseCompletion
Puntatore a un NdkCloseCompletion funzione di callback di completamento di chiusura (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 |
|---|---|
|
L'oggetto NDK è chiuso. Il provider non chiamerà la funzione NdkCloseCompletion. |
|
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. |
|
Si è verificato un errore. |
Osservazioni
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 che vengano impediti ulteriori 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.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Nessuna supportata, supportata in NDIS 6.30 e versioni successive. |
| server minimo supportato | Windows Server 2012 |
| piattaforma di destinazione | Finestre |
| intestazione | ndkpi.h (include Ndkpi.h) |
| IRQL | <=DISPATCH_LEVEL |