Handle oggetti SerCx2
Questo argomento descrive i tipi di handle degli oggetti definiti in modo specifico per la versione 2 dell'estensione del framework seriale (SerCx2).
L'interfaccia del driver del dispositivo SerCx2 usa questi tipi di handle per fare riferimento a oggetti con funzionalità e funzionalità specifiche di SerCx2.
Inoltre, SerCx2 DDI usa due dei tipi di handle di oggetti generici, WDFDEVICE e WDFREQUEST, definiti dal Kernel-Mode Driver Framework (KMDF).
Per altre informazioni sui tipi di handle del framework, vedere Riepilogo degli oggetti Framework.
Questo argomento descrive gli handle degli oggetti seguenti:
- Handle oggetto SERCX2CUSTOMRECEIVE
- Handle oggetti SERCX2CUSTOMRECEIVETRANSACTION
- Handle oggetto SERCX2CUSTOMTRANSMIT
- Handle oggetto SERCX2CUSTOMTRANSMITTRANSACTION
- Handle oggetto SERCX2PIORECEIVE
- Handle oggetto SERCX2PIOTRANSMIT
- Handle di oggetti SERCX2SYSTEMDMARECEIVE
- Handle oggetto SERCX2SYSTEMDMATRANSMIT
Intestazione: 2.0\Sercx.h
Handle oggetto SERCX2CUSTOMRECEIVE
Un handle di oggetti SERCX2CUSTOMRECEIVE è un riferimento opaco a un oggetto di ricezione personalizzato nella versione 2 dell'estensione del framework seriale (SerCx2).
Il metodo SerCx2CustomReceiveCreate crea un oggetto di ricezione personalizzato. SerCx2 usa questo oggetto per gestire le transazioni di I/O che usano un meccanismo di trasferimento dati personalizzato per leggere i dati dal controller seriale. Questo oggetto è opaco ai driver del controller seriale.
SerCx2CustomReceiveCreate fornisce, come parametro di output, un handle SERCX2CUSTOMRECEIVE all'oggetto di ricezione personalizzato appena creato.
SerCx2 e il driver del controller seriale usano questo handle per fare riferimento all'oggetto nelle chiamate successive ai metodi SerCx2 e alle funzioni di callback degli eventi.
Dopo Che SerCx2CustomReceiveCreate crea l'oggetto di ricezione personalizzato, questo oggetto esiste per la durata dell'oggetto dispositivo framework che rappresenta il dispositivo controller seriale. L'oggetto di ricezione personalizzato viene eliminato automaticamente quando l'oggetto dispositivo viene eliminato. Il driver del controller seriale non deve provare a eliminare l'oggetto di ricezione personalizzato chiamando un metodo come WdfObjectDelete.
Un driver del controller seriale può, come opzione, creare un oggetto di ricezione personalizzato, ma non può creare più di un oggetto di questo tipo.
Il driver può creare questo oggetto solo in base alle condizioni seguenti:
- Il driver ha creato in precedenza un oggetto di ricezione PIO.
- Il driver non ha creato un oggetto system-DMA-receive.
Per altre informazioni sugli oggetti PIO-receive, vedere SERCX2PIORECEIVE Object Handle.
Per altre informazioni sugli oggetti system-DMA-receive, vedere SERCX2SYSTEMDMARECEIVE Object Handle.
Handle oggetti SERCX2CUSTOMRECEIVETRANSACTION
Un handle dell'oggetto SERCX2CUSTOMRECEIVETRANSACTION è un riferimento opaco a un oggetto custom-receive-transaction nella versione 2 dell'estensione del framework seriale (SerCx2).
Il metodo SerCx2CustomReceiveTransactionCreate crea un oggetto custom-receive-transaction. SerCx2 usa questo oggetto per gestire le transazioni di I/O che usano un meccanismo di trasferimento dati personalizzato per leggere i dati ricevuti dal controller seriale.
Questo oggetto è opaco ai driver del controller seriale.
SerCx2CustomReceiveTransactionCreate supplies, come parametro di output, un handle SERCX2CUSTOMRECEIVETRANSACTION all'oggetto custom-receive-transaction appena creato.
SerCx2 e il driver del controller seriale usano questo handle per fare riferimento all'oggetto nelle transazioni di ricezione personalizzate successive.
Per altre informazioni, vedere SerCx2 Custom-Receive Transazioni.
Dopo SerCx2CustomReceiveTransactionCreate crea l'oggetto custom-receive-transaction, questo oggetto esiste per la durata dell'oggetto dispositivo framework che rappresenta il dispositivo controller seriale.
L'oggetto custom-receive-transaction viene eliminato automaticamente quando l'oggetto dispositivo viene eliminato.
Il driver del controller seriale non deve provare a eliminare l'oggetto custom-receive-transaction chiamando un metodo come WdfObjectDelete.
Un driver del controller seriale può, come opzione, creare un oggetto di transazione di ricezione personalizzato, ma non può creare più di un oggetto di questo tipo.
Il driver può creare questo oggetto solo nelle condizioni seguenti:/wdcml:<p>
- Il driver ha creato in precedenza un oggetto di ricezione PIO.
- Il driver ha creato in precedenza un oggetto di ricezione personalizzato.
Per altre informazioni sugli oggetti PIO-receive, vedere SERCX2PIORECEIVE Object Handle. Per altre informazioni sugli oggetti di ricezione personalizzati, vedere HANDLE oggetti SERCX2CUSTOMRECEIVE.
Nonostante la durata simile di oggetti di ricezione personalizzata e di transazione personalizzata, questi vengono definiti come tipi di oggetti separati (e non combinati in un tipo) per supportare la possibile espansione futura dell'interfaccia del driver del dispositivo SerCx2.
Handle oggetto SERCX2CUSTOMTRANSMIT
Un handle di oggetti SERCX2CUSTOMTRANSMIT è un riferimento opaco a un oggetto di trasmissione personalizzato nella versione 2 dell'estensione del framework seriale (SerCx2).
Il metodo SerCx2CustomTransmitCreate crea un oggetto di trasmissione personalizzato.h SerCx2 usa questo oggetto per gestire le transazioni di I/O che scrivono dati nel controller seriale. Questo oggetto è opaco ai driver del controller seriale.
SerCx2CustomTransmitCreate fornisce, come parametro di output, un handle SERCX2CUSTOMTRANSMIT all'oggetto di trasmissione personalizzato appena creato. SerCx2 e il driver del controller seriale usano questo handle per fare riferimento all'oggetto nelle chiamate successive ai metodi SerCx2 e alle funzioni di callback degli eventi.
Dopo che SerCx2CustomTransmitCreate crea l'oggetto di trasmissione personalizzato, questo oggetto esiste per la durata dell'oggetto dispositivo framework che rappresenta il dispositivo controller seriale.
L'oggetto di trasmissione personalizzato viene eliminato automaticamente quando l'oggetto dispositivo viene eliminato. Il driver del controller seriale non deve provare a eliminare l'oggetto di trasmissione personalizzato chiamando un metodo come WdfObjectDelete.
Un driver del controller seriale può, come opzione, creare un oggetto di trasmissione personalizzato, ma non può creare più di un oggetto di questo tipo.
Il driver può creare questo oggetto solo in base alle condizioni seguenti:
- Il driver ha creato in precedenza un oggetto di trasmissione PIO.
- Il driver non ha creato un oggetto system-DMA-transmit.
Per altre informazioni sugli oggetti di trasmissione PIO, vedere SERCX2PIOTRANSMIT Object Handle. Per altre informazioni sugli oggetti system-DMA-transmit, vedere SERCX2SYSTEMDMATRANSMIT Object Handle.
Handle oggetto SERCX2CUSTOMTRANSMITTRANSACTION
Un handle dell'oggetto SERCX2CUSTOMTRANSTRANSACTION è un riferimento opaco a un oggetto di transazione di trasmissione personalizzata nella versione 2 dell'estensione del framework seriale (SerCx2).
Il metodo SerCx2CustomTransmitTransactionCreate crea un oggetto di transazione di trasmissione personalizzato. SerCx2 usa questo oggetto per gestire le transazioni di I/O che usano un meccanismo di trasferimento dati personalizzato per scrivere dati nel controller seriale. Questo oggetto è opaco ai driver del controller seriale.
SerCx2CustomTransmitTransactionCreate fornisce, come parametro di output, un handle SERCX2CUSTOMTRANSMITTRANSACTION all'oggetto custom-transmit-transaction appena creato. SerCx2 e il driver del controller seriale usano questo handle per fare riferimento all'oggetto nelle transazioni di trasmissione personalizzate successive.
Per altre informazioni, vedere SerCx2 Custom-Transmit Transazioni.
Dopo SerCx2CustomTransactionCreate crea l'oggetto custom-transmit-transaction, questo oggetto esiste per la durata dell'oggetto dispositivo framework che rappresenta il dispositivo controller seriale. L'oggetto di transazione di trasmissione personalizzata viene eliminato automaticamente quando l'oggetto dispositivo viene eliminato. Il driver del controller seriale non deve provare a eliminare l'oggetto di transazione di trasmissione personalizzata chiamando un metodo come WdfObjectDelete.
Un driver del controller seriale può, come opzione, creare un oggetto di trasmissione personalizzato, ma non può creare più di un oggetto di questo tipo. Il driver può creare questo oggetto solo in base alle condizioni seguenti:
- Il driver ha creato in precedenza un oggetto di trasmissione PIO.
- Il driver non ha creato un oggetto system-DMA-transmit.
Per altre informazioni sugli oggetti di trasmissione PIO, vedere SERCX2PIOTRANSMIT Object Handle. Per altre informazioni sugli oggetti di trasmissione personalizzati, vedere SERCX2CUSTOMTRANSMIT Object Handle.
Nonostante la durata simile di oggetti di trasmissione personalizzata e transazioni personalizzate, questi sono definiti come tipi di oggetti separati (e non combinati in un tipo) per supportare la possibile espansione futura dell'interfaccia del driver del dispositivo SerCx2.
Handle oggetto SERCX2PIORECEIVE
Un handle di oggetti SERCX2PIORECEIVE è un riferimento opaco a un oggetto di ricezione PIO nella versione 2 dell'estensione del framework seriale (SerCx2).
Il metodo SerCx2PioReceiveCreate crea un oggetto di ricezione PIO. SerCx2 usa l'oggetto per gestire le transazioni di I/O programmate che leggeno i dati dal controller seriale. Questo oggetto è opaco ai driver del controller seriale. fornisce, come parametro di output, un handle SERCX2PIORECEIVE all'oggetto PIO-receive appena creato. SerCx2 e il driver del controller seriale usano questo handle per fare riferimento all'oggetto nelle transazioni di ricezione PIO successive.
Per altre informazioni, vedere SerCx2 PIO-Receive Transazioni. Dopo che SerCx2PioReceiveCreate crea l'oggetto PIO-receive, questo oggetto esiste per la durata dell'oggetto dispositivo framework che rappresenta il dispositivo controller seriale. L'oggetto PIO-receive viene eliminato automaticamente quando l'oggetto dispositivo viene eliminato. Il driver del controller seriale non deve provare a eliminare l'oggetto di ricezione PIO chiamando un metodo come WdfObjectDelete.
Un driver del controller seriale deve creare uno e un solo oggetto di ricezione PIO. Il driver deve creare questo oggetto prima di creare un oggetto system-DMA-receive o un oggetto di ricezione personalizzato. Per altre informazioni sugli oggetti system-DMA-receive, vedere SERCX2SYSTEMDMARECEIVE Object Handle. Per altre informazioni sugli oggetti di ricezione personalizzati, vedere HANDLE oggetti SERCX2CUSTOMRECEIVE.
Handle oggetto SERCX2PIOTRANSMIT
Un handle di oggetto SERCX2PIOTRANSMIT è un riferimento opaco a un oggetto di trasmissione PIO nella versione 2 dell'estensione del framework seriale (SerCx2).
Il metodo SerCx2PioTransmitCreate crea un oggetto di trasmissione PIO. SerCx2 usa questo oggetto per gestire le transazioni di I/O che usano operazioni di I/O programmate per scrivere dati nel controller seriale. Questo oggetto è opaco ai driver del controller seriale. SerCx2PioTransmitCreate fornisce, come parametro di output, un handle SERCX2PIOTRANSMIT per l'oggetto PIO-transmit appena creato. SerCx2 e il driver del controller seriale usano questo handle per fare riferimento all'oggetto nelle successive transazioni di trasmissione PIO. Per altre informazioni, vedere SerCx2 PIO-Transmit Transactions. Dopo che SerCx2PioTransmitCreate crea l'oggetto di trasmissione PIO, questo oggetto esiste per la durata dell'oggetto dispositivo framework che rappresenta il dispositivo controller seriale. L'oggetto di trasmissione PIO viene eliminato automaticamente quando l'oggetto dispositivo viene eliminato. Il driver del controller seriale non deve tentare di eliminare l'oggetto di trasmissione PIO chiamando un metodo come WdfObjectDelete.
Un driver controller seriale deve creare uno e un solo oggetto di trasmissione PIO. Il driver deve creare questo oggetto prima di creare un oggetto di trasmissione DMA di sistema o un oggetto di trasmissione personalizzato. Per altre informazioni sugli oggetti system-DMA-transmit, vedere SERCX2SYSTEMDMATRANSMIT Object Handle. Per altre informazioni sugli oggetti di trasmissione personalizzata, vedere SERCX2CUSTOMTRANSMIT Object Handle.
Handle dell'oggetto SERCX2SYSTEMDMARECEIVE
Un handle di oggetto SERCX2SYSTEMDMARECEIVE è un riferimento opaco a un oggetto system-DMA-receive nella versione 2 dell'estensione del framework seriale (SerCx2).
Il metodo SerCx2SystemDmaReceiveCreate crea un oggetto system-DMA-receive. SerCx2 usa questo oggetto per gestire le transazioni DMA di sistema che leggono i dati dal controller seriale. Questo oggetto è opaco ai driver del controller seriale. SerCx2SystemDmaReceiveCreate fornisce, come parametro di output, un handle SERCX2SYSTEMDMARECEIVE per l'oggetto system-DMA-receive appena creato. SerCx2 e il driver del controller seriale usano questo handle per fare riferimento all'oggetto nelle successive transazioni system-DMA-receive. Per altre informazioni, vedere Transazioni SerCx2 System-DMA-Receive.
Dopo che SerCx2SystemDmaReceiveCreate crea l'oggetto system-DMA-receive, questo oggetto esiste per la durata dell'oggetto dispositivo framework che rappresenta il dispositivo controller seriale. L'oggetto system-DMA-receive viene eliminato automaticamente quando l'oggetto dispositivo viene eliminato. Un driver controller seriale può, come opzione, creare un oggetto system-DMA-receive, ma non può creare più di un oggetto di questo tipo. Il driver può creare questo oggetto solo nelle condizioni seguenti:
- Il driver ha creato in precedenza un oggetto di ricezione PIO.
- Il driver non ha creato un oggetto di ricezione personalizzato.
Per altre informazioni sugli oggetti PIO-receive, vedere SERCX2PIORECEIVE Object Handle. Per altre informazioni sugli oggetti di ricezione personalizzati, vedere SERCX2CUSTOMRECEIVE Object Handle.
Handle dell'oggetto SERCX2SYSTEMDMATRANSMIT
Un handle di oggetto SERCX2SYSTEMDMATRANSMIT è un riferimento opaco a un oggetto di trasmissione system-DMA nella versione 2 dell'estensione del framework seriale (SerCx2).
Il metodo SerCx2SystemDmaTransmitCreate crea un oggetto system-DMA-transmit. SerCx2 usa questo oggetto per gestire le transazioni DMA di sistema che scrivono dati nel controller seriale. Questo oggetto è opaco ai driver del controller seriale. SerCx2SystemDmaTransmitCreate fornisce, come parametro di output, un handle SERCX2SYSTEMDMATRANSMIT all'oggetto system-DMA-transmit appena creato. SerCx2 e il driver del controller seriale usano questo handle per fare riferimento all'oggetto nelle successive transazioni di trasmissione DMA di sistema. Per altre informazioni, vedere Transazioni SerCx2 System-DMA-Transmit.
Dopo che SerCx2SystemDmaTransmitCreate crea l'oggetto system-DMA-transmit, questo oggetto esiste per la durata dell'oggetto dispositivo framework che rappresenta il dispositivo controller seriale. L'oggetto system-DMA-transmit viene eliminato automaticamente quando l'oggetto dispositivo viene eliminato. Il driver del controller seriale non deve tentare di eliminare l'oggetto di trasmissione system-DMA chiamando un metodo come WdfObjectDelete.
Un driver controller seriale può, come opzione, creare un oggetto di trasmissione DMA di sistema, ma non può creare più di un oggetto di questo tipo. Il driver può creare questo oggetto solo nelle condizioni seguenti:</wdcml:p>
- Il driver ha creato in precedenza un oggetto di trasmissione PIO.
- Il driver non ha creato un oggetto di trasmissione personalizzato.
Per altre informazioni sugli oggetti di trasmissione PIO, vedere SERCX2PIOTRANSMIT Object Handle. Per altre informazioni sugli oggetti di trasmissione personalizzata, vedere SERCX2CUSTOMTRANSMIT Object Handle.
Argomenti correlati
Transazioni Custom-Receive SerCx2
Transazioni Custom-Transmit SerCx2
Transazioni PIO-Receive SerCx2
Transazioni PIO-Transmit SerCx2
Transazioni SerCx2 System-DMA-Receive
Transazioni SerCx2 System-DMA-Transmit
SerCx2CustomReceiveTransactionCreate
SerCx2CustomTransmitTransactionCreate
Commenti e suggerimenti
Presto disponibile: nel corso del 2024 verranno dismessi i problemi di GitHub come meccanismo di feedback per il contenuto e verranno sostituiti con un nuovo sistema di feedback. Per altre informazioni, vedere: https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per