EVT_SERCX2_FILEOPEN funzione di callback (sercx.h)

  • Articolo

La funzione di callback dell'evento EvtSerCx2FileOpen 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 nella relativa funzione di callback EvtDriverDeviceAdd . 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.

Commenti

Il driver del controller seriale può, come opzione, implementare questa funzione. Se implementato, il driver registra questa funzione nella chiamata al metodo SerCx2InitializeDevice 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 Oggetti file framework.

Esempio

Per definire una funzione di callback EvtSerCx2FileOpen , è necessario innanzitutto 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 tramite i tipi di funzione di callback consente di analizzare il codice per i driver, l'SDV ( Static Driver Verifier ) e altri strumenti di verifica di trovare errori ed è un requisito per la scrittura di driver per il sistema operativo Windows.

Ad esempio, per definire una funzione di callback EvtSerCx2FileOpen denominata MyFileOpen, usare il tipo di funzione EVT_SERCX2_FILEOPEN , come illustrato nell'esempio di codice seguente:

EVT_SERCX2_FILEOPEN  MyFileOpen;

Implementare quindi la funzione di callback come indicato di seguito:

_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 tipi di ruolo di funzione per i driver KMDF. Per altre informazioni sulle Use_decl_annotations, vedere Annotazione del comportamento della funzione.

Requisiti

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.

Vedi anche

SerCx2InitializeDevice