EVT_SERCX2_FILEOPEN funzione di callback (sercx.h)
La EvtSerCx2FileOpen funzione di callback degli eventi viene chiamata dalla versione 2 dell'estensione del framework seriale (SerCx2) per notificare al driver del controller seriale che un client ha aperto una connessione logica al dispositivo controller seriale e che è stato creato un oggetto file per rappresentare questa connessione.
Sintassi
EVT_SERCX2_FILEOPEN EvtSercx2Fileopen;
NTSTATUS EvtSercx2Fileopen(
[in] WDFDEVICE Device
)
{...}
Parametri
[in] Device
Handle WDFDEVICE per l'oggetto dispositivo framework che rappresenta il controller seriale. Il driver del controller seriale ha creato questo oggetto nel relativo EvtDriverDeviceAdd funzione di callback. Per altre informazioni, vedere SerCx2InitializeDevice.
Valore restituito
La funzione EvtSerCx2FileOpen restituisce STATUS_SUCCESS se la chiamata ha esito positivo. In caso contrario, restituisce un codice di stato di errore appropriato.
Osservazioni
Il driver del controller seriale può, come opzione, implementare questa funzione. Se implementato, il driver registra questa funzione nella chiamata al SerCx2InitializeDevice metodo che completa l'inizializzazione dell'oggetto dispositivo framework per il controller seriale. SerCx2 chiama la funzione EvtSerCx2FileOpen quando un driver client apre un handle di file allo stack di driver del controller seriale.
Per altre informazioni, vedere Framework File Objects.
Esempi
Per definire un EvtSerCx2FileOpen funzione di callback, è prima necessario fornire una dichiarazione di funzione che identifica il tipo di funzione di callback che si sta definendo. Windows fornisce un set di tipi di funzione di callback per i driver. La dichiarazione di una funzione usando i tipi di funzione di callback consente di
Ad esempio, per definire un EvtSerCx2FileOpen funzione di callback denominata MyFileOpen, usare il tipo di funzione EVT_SERCX2_FILEOPEN, come illustrato in questo esempio di codice:
EVT_SERCX2_FILEOPEN MyFileOpen;
Implementare quindi la funzione di callback come segue:
_Use_decl_annotations_
NTSTATUS
MyFileOpen(
WDFDEVICE Device
)
{...}
Il tipo di funzione EVT_SERCX2_FILEOPEN è definito nel file di intestazione Sercx.h. Per identificare in modo più accurato gli errori quando si eseguono gli strumenti di analisi del codice, assicurarsi di aggiungere l'annotazione Use_decl_annotations alla definizione della funzione. L'annotazione Use_decl_annotations assicura che vengano utilizzate le annotazioni applicate al tipo di funzione EVT_SERCX2_FILEOPEN nel file di intestazione. Per altre informazioni sui requisiti per le dichiarazioni di funzione, vedere Dichiarazione di funzioni tramite i tipi di ruolo della funzione per i driver KMDF. Per altre informazioni su Use_decl_annotations, vedere l'annotazione del comportamento della funzione.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile a partire da Windows 8.1. |
| piattaforma di destinazione | Desktop |
| intestazione |
sercx.h |
| IRQL | Chiamato in IRQL <= DISPATCH_LEVEL. |