EVT_SERCX_FILEOPEN funzione di callback (sercx.h)

  • Articolo

La funzione di callback dell'evento EvtSerCxFileOpen notifica al driver del controller seriale che un client ha aperto un handle di file nel dispositivo 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.

Commenti

L'estensione del framework seriale (SerCx) chiama questa funzione per preparare l'hardware del controller seriale per accettare le richieste per le 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 di interrupt.

Per registrare una funzione di callback EvtSerCxFileOpen , 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 NTSTATUS
  EVT_SERCX_FILEOPEN(
    __in WDFDEVICE Device
    );

Per definire una funzione di callback EvtSerCxFileOpen denominata MyEvtSerCxFileOpen, è innanzitutto necessario fornire una dichiarazione di funzione richiesta da 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 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

Vedi anche

SerCxInitialize