EVT_SERCX_FILEOPEN funzione di callback (sercx.h)
Il EvtSerCxFileOpen funzione di callback dell'evento notifica al driver del controller seriale che un client ha aperto un handle di file nel dispositivo del controller seriale e che è stato creato un oggetto file per rappresentare il dispositivo.
Sintassi
EVT_SERCX_FILEOPEN EvtSercxFileopen;
NTSTATUS EvtSercxFileopen(
[in] WDFDEVICE Device
)
{...}
Parametri
[in] Device
Handle WDFDEVICE per l'oggetto dispositivo framework che rappresenta il controller seriale.
Valore restituito
La funzione EvtSerCxFileOpen restituisce STATUS_SUCCESS se la chiamata ha esito positivo. In caso contrario, restituisce un codice di stato di errore appropriato.
Osservazioni
L'estensione del framework seriale (SerCx) chiama questa funzione per preparare l'hardware del controller seriale per accettare le richieste di operazioni di I/O. Questa funzione deve configurare il controller in uno stato in cui è pronto per ricevere e trasmettere i dati. Se sono necessari interrupt, questa funzione deve abilitare gli interrupt. Inoltre, questa funzione deve allocare qualsiasi memoria necessaria solo durante la durata dell'oggetto file. Ad esempio, questa funzione può allocare un buffer di dati interrupt.
Per registrare un EvtSerCxFileOpen 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 NTSTATUS
EVT_SERCX_FILEOPEN(
__in WDFDEVICE Device
);
Per definire un EvtSerCxFileOpen funzione di callback denominata MyEvtSerCxFileOpen, è prima necessario fornire una dichiarazione di funzione che Static Driver Verifier (SDV) e altri strumenti di verifica, come indicato di seguito.
EVT_SERCX_FILEOPEN MyEvtSerCxFileOpen;
Implementare quindi la funzione di callback come indicato di seguito.
NTSTATUS
MyEvtSerCxFileOpen(
__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 |