EVT_SERCX_FILECLOSE funzione di callback (sercx.h)

Articolo
12/15/2024

La funzione di callback dell'evento evtSerCxFileClose notifica al driver del controller seriale che l'oggetto file che rappresenta il dispositivo del controller seriale è stato 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 un EvtSerCxFileClose funzione di callback, il driver deve chiamare il metodo SerCxInitialize.

Per altre informazioni, vedere Framework File Objects.

Esempi

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 un EvtSerCxFileClose funzione di callback denominata MyEvtSerCxFileClose, è prima necessario fornire una dichiarazione di funzione che 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 i tipi di ruolo della funzione per i driver KMDF.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile a partire da Windows 8.
piattaforma di destinazione	Desktop
intestazione	sercx.h
IRQL	Chiamato in IRQL <= DISPATCH_LEVEL

Vedere anche

EvtSerCxFileCleanup

SerCxInitialize

Condividi tramite