Funzione SerCx2PioReceiveCreate (sercx.h)
Il metodo SerCx2PioReceiveCreate crea un oggetto PIO-receive, che la versione 2 dell'estensione del framework seriale (SerCx2) usa per eseguire transazioni di ricezione PIO.
Sintassi
NTSTATUS SerCx2PioReceiveCreate(
[in] WDFDEVICE Device,
[in] PSERCX2_PIO_RECEIVE_CONFIG PioReceiveConfig,
[in, optional] PWDF_OBJECT_ATTRIBUTES Attributes,
[out] SERCX2PIORECEIVE *PioReceive
);
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 EvtDriverDeviceAdd callback. Per altre informazioni, vedere SerCx2InitializeDevice.
[in] PioReceiveConfig
Puntatore a una struttura SERCX2_PIO_RECEIVE_CONFIG . Prima di chiamare questo metodo, il chiamante deve chiamare la funzione SERCX2_PIO_RECEIVE_CONFIG_INIT per inizializzare la struttura. Questa struttura contiene puntatori a un set di routine di callback eventi implementate dal driver del controller seriale. SerCx2 chiama queste funzioni per eseguire transazioni di ricezione PIO.
[in, optional] Attributes
Puntatore a una struttura WDF_OBJECT_ATTRIBUTES che descrive gli attributi da assegnare al nuovo oggetto di ricezione PIO. Prima di chiamare questo metodo, il chiamante deve chiamare la funzione WDF_OBJECT_ATTRIBUTES_INIT per inizializzare la struttura. Questo parametro è facoltativo e può essere specificato come WDF_NO_OBJECT_ATTRIBUTES se il driver del controller seriale non deve assegnare attributi all'oggetto. Per altre informazioni, vedere la sezione Osservazioni.
[out] PioReceive
Puntatore a un percorso in cui questo metodo scrive un handle SERCX2PIORECEIVE nell'oggetto PIO-receive appena creato. SerCx2 e il driver del controller seriale usano questo handle nelle chiamate successive per fare riferimento a questo oggetto.
Valore restituito
Questo metodo restituisce STATUS_SUCCESS se la chiamata ha esito positivo. I valori restituiti degli errori possibili includono i codici di stato seguenti.
Codice restituito | Descrizione |
---|---|
|
Un oggetto PIO-receive esiste già da una chiamata serCx2PioReceiveCreate precedente. |
|
Il valore Config->Size non è uguale a sizeof(SERCX2_PIO_RECEIVE_CONFIG). |
|
La combinazione specificata di funzioni di callback implementate non è valida. Il driver deve implementare le funzioni EvtSerCx2PioReceiveReadBuffer, EvtSerCx2PioReceiveEnableReadyNotification e EvtSerCx2PioReceiveCancelReadyNotification . |
|
Sono disponibili risorse insufficienti per eseguire l'operazione richiesta. |
Commenti
Il driver del controller seriale chiama questo metodo per creare un oggetto di ricezione PIO. SerCx2 usa questo oggetto per eseguire transazioni di ricezione PIO, che usano I/O programmate per leggere i dati ricevuti dal controller seriale.
In genere, un driver del controller seriale chiama SerCx2PioReceiveCreate dalla sua funzione EvtDriverDeviceAdd . Il driver deve chiamare questo metodo solo dopo che chiama correttamente il metodo SerCx2InitializeDevice .
Come opzione, un driver del controller seriale può usare il parametro Attributes per creare un contesto per l'oggetto PIO-receive e fornire puntatori alle funzioni EvtCleanupCallback e EvtDestroyCallback che vengono chiamate per preparare l'oggetto per l'eliminazione. Per altre informazioni, vedere WDF_OBJECT_ATTRIBUTES.
Se il parametro Attributes punta a una struttura WDF_OBJECT_ATTRIBUTES , il chiamante non deve sovrascrivere i valori scritti dalla funzione di inizializzazione WDF_OBJECT_ATTRIBUTES_INIT ai membri ParentObject, ExecutionLevel e SyncScope di questa struttura.
Per altre informazioni sulla creazione di oggetti di ricezione PIO, vedere SERCX2PIORECEIVE. Per altre informazioni sulle transazioni di ricezione PIO, vedere SerCx2 PIO-Receive Transazioni.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Disponibile a partire da Windows 8.1. |
Piattaforma di destinazione | Universale |
Intestazione | sercx.h |
IRQL | <= DISPATCH_LEVEL |
Vedi anche
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per