Funzione SerCxInitialize (sercx.h)
Il metodo SerCxInitialize completa l'inizializzazione dell'estensione del framework seriale (SerCx) dopo che questo driver crea l'oggetto dispositivo associato.
Sintassi
NTSTATUS SerCxInitialize(
[in] WDFDEVICE FxDevice,
[in] PSERCX_CONFIG Config
);
Parametri
[in] FxDevice
Handle WDFDEVICE per l'oggetto dispositivo framework che rappresenta il controller seriale.
[in] Config
Puntatore a una struttura di SERCX_CONFIG allocata dal chiamante che contiene informazioni di configurazione per SerCx. Il chiamante ha precedentemente chiamato la funzione SERCX_CONFIG_INIT per inizializzare questa struttura.
Valore restituito
SerCxInitialize restituisce STATUS_SUCCESS se ha esito positivo. I valori restituiti di errore possibili includono i codici di stato seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Il metodo è stato chiamato in irQL errato; o l'handle WDFDEVICE non è valido; o FxDevice o Config è NULL. |
|
Impossibile allocare risorse di sistema (in genere memoria). |
Osservazioni
Il driver del controller seriale chiama questo metodo dopo aver creato l'oggetto dispositivo associato.
SerCxInitialize registra le funzioni di callback I/O del driver controller con SerCx. Inoltre, questo metodo definisce la modalità di trasferimento per la coda di I/O. Durante la chiamata, questo metodo crea tutte le strutture interne richieste da SerCx (inclusa la coda di I/O per il controller seriale). Al termine di questo metodo, SerCx è pronto per l'elaborazione dell'I/O. Tuttavia, il driver del controller potrebbe configurare le impostazioni hardware del controller prima che venga restituito dal EvtDriverDeviceAdd callback o prima di aggiungere il PDO all'elenco figlio.
Se i parametri non sono validi (come descritto in SERCX_CONFIG), Driver Verifier genererà un errore.
Questa routine deve essere chiamata prima di eseguire il commit del dispositivo (restituendo da EvtDriverDeviceAdd o aggiungendo il PDO all'elenco figlio).
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile a partire da Windows 8. |
| piattaforma di destinazione | Universale |
| intestazione |
sercx.h |
| IRQL | PASSIVE_LEVEL |