EVT_SERCX_FILECLOSE funzione di callback (sercx.h)
La funzione di callback dell'evento EvtSerCxFileClose notifica al driver del controller seriale che l'oggetto file che rappresenta il dispositivo controller seriale rilasciato.
Sintassi
EVT_SERCX_FILECLOSE EvtSercxFileclose;
void EvtSercxFileclose(
[in] WDFDEVICE Device
)
{...}
Parametri
[in] Device
Handle WDFDEVICE per l'oggetto dispositivo framework che rappresenta il controller seriale.
Valore restituito
nessuno
Osservazioni
Questa funzione deve rimuovere il dispositivo controller seriale dallo stato in cui è pronto per ricevere e trasmettere i dati. Questa funzione deve disabilitare gli interrupt se sono abilitati gli interrupt. Qualsiasi memoria allocata solo per la durata dell'oggetto file deve essere deallocata in questa funzione o nella funzione EvtSerCxFileCleanup .
Se il driver del controller seriale implementa una funzione EvtSerCxFileCleanup , l'estensione del framework seriale (SerCx) chiama questa funzione prima di chiamare la funzione EvtSerCxFileClose . SerCx chiama la funzione EvtSerCxFileCleanup quando un client chiude l'ultimo handle all'oggetto file che rappresenta il dispositivo controller seriale. Dopo questa chiamata, il driver non riceve nuove richieste per le operazioni di I/O. SerCx chiama la funzione EvtSerCxFileClose quando viene rilasciato l'oggetto file, che si verifica solo dopo il completamento o l'annullamento di tutte le richieste di I/O in sospeso.
Per registrare una funzione di callback EvtSerCxFileClose , il driver deve chiamare il metodo SerCxInitialize .
Per altre informazioni, vedere Oggetti file framework.
Esempio
Il tipo di funzione per questo callback viene dichiarato in Sercx.h, come indicato di seguito.
typedef VOID
EVT_SERCX_FILECLOSE(
__in WDFDEVICE Device
);
Per definire una funzione di callback EvtSerCxFileClose denominata MyEvtSerCxFileClose, è necessario innanzitutto fornire una dichiarazione di funzione richiesta da Static Driver Verifier (SDV) e altri strumenti di verifica, come indicato di seguito.
EVT_SERCX_FILECLOSE MyEvtSerCxFileClose;
Implementare quindi la funzione di callback come indicato di seguito.
VOID
MyEvtSerCxFileClose(
__in WDFDEVICE Device
)
{ ... }
Per altre informazioni sui requisiti SDV per le dichiarazioni di funzione, vedere Dichiarazione di funzioni tramite tipi di ruolo per i driver KMDF.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile a partire da Windows 8. |
| Piattaforma di destinazione | Desktop |
| Intestazione | sercx.h |
| IRQL | Chiamato in IRQL <= DISPATCH_LEVEL |