Handles d’objet SerCx2
Cette rubrique décrit les types de handle d’objet qui sont spécifiquement définis pour la version 2 de l’extension d’infrastructure série (SerCx2).
L’interface de pilote de périphérique (DDI) SerCx2 utilise ces types de handle pour faire référence à des objets qui ont des fonctionnalités et des fonctionnalités spécifiques à SerCx2.
En outre, le DDI SerCx2 utilise deux des types de handle d’objets génériques, WDFDEVICE et WDFREQUEST, qui sont définis par le Kernel-Mode Driver Framework (KMDF).
Pour plus d’informations sur les types de handle d’infrastructure, consultez Résumé des objets framework.
Cette rubrique décrit les handles d’objets suivants :
- SERCX2CUSTOMRECEIVE, handle d’objet
- SERCX2CUSTOMRECEIVETRANSACTION, handle d’objet
- SERCX2CUSTOMTRANSMIT Object Handle
- SERCX2CUSTOMTRANSMITTRANSACTION Object Handle
- SERCX2PIORECEIVE, handle d’objet
- Handle d’objet SERCX2PIOTRANSMIT
- Handle d’objet SERCX2SYSTEMDMARECEIVE
- SERCX2SYSTEMDMATRANSMIT Object Handle
En-tête : 2.0\Sercx.h
SERCX2CUSTOMRECEIVE, handle d’objet
Un handle d’objet SERCX2CUSTOMRECEIVE est une référence opaque à un objet de réception personnalisé dans la version 2 de l’extension d’infrastructure série (SerCx2).
La méthode SerCx2CustomReceiveCreate crée un objet de réception personnalisé. SerCx2 utilise cet objet pour gérer les transactions d’E/S qui utilisent un mécanisme de transfert de données personnalisé pour lire les données du contrôleur série. Cet objet est opaque pour les pilotes de contrôleur série.
SerCx2CustomReceiveCreate fournit, en tant que paramètre de sortie, un handle SERCX2CUSTOMRECEIVE à l’objet custom-receive nouvellement créé.
SerCx2 et le pilote de contrôleur série utilisent ce handle pour faire référence à l’objet dans les appels suivants aux méthodes SerCx2 et aux fonctions de rappel d’événement.
Une fois que SerCx2CustomReceiveCreate a créé l’objet custom-receive, cet objet existe pendant la durée de vie de l’objet d’appareil framework qui représente l’appareil de contrôleur série. L’objet de réception personnalisé est automatiquement supprimé lorsque l’objet d’appareil est supprimé. Le pilote de contrôleur série ne doit pas essayer de supprimer l’objet de réception personnalisé en appelant une méthode telle que WdfObjectDelete.
Un pilote de contrôleur série peut, en option, créer un objet de réception personnalisé, mais ne peut pas créer plus d’un objet de ce type.
Le pilote peut créer cet objet uniquement dans les conditions suivantes :
- Le pilote a précédemment créé un objet PIO-receive.
- Le pilote n’a pas créé d’objet system-DMA-receive.
Pour plus d’informations sur les objets PIO-receive, consultez SERCX2PIORECEIVE Object Handle.
Pour plus d’informations sur les objets system-DMA-receive, consultez SERCX2SYSTEMDMARECEIVE Object Handle.
SERCX2CUSTOMRECEIVETRANSACTION, handle d’objet
Un handle d’objet SERCX2CUSTOMRECEIVETRANSACTION est une référence opaque à un objet de réception-transaction personnalisé dans la version 2 de l’extension d’infrastructure série (SerCx2).
La méthode SerCx2CustomReceiveTransactionCreate crée un objet custom-receive-transaction. SerCx2 utilise cet objet pour gérer les transactions d’E/S qui utilisent un mécanisme de transfert de données personnalisé pour lire les données reçues par le contrôleur série.
Cet objet est opaque pour les pilotes de contrôleur série.
SerCx2CustomReceiveTransactionCreate fournit, en tant que paramètre de sortie, un handle SERCX2CUSTOMRECEIVETRANSACTION à l’objet custom-receive-transaction nouvellement créé.
SerCx2 et le pilote de contrôleur série utilisent ce handle pour faire référence à l’objet dans les transactions de réception personnalisée suivantes.
Pour plus d’informations, consultez Transactions SerCx2 Custom-Receive.
Une fois que SerCx2CustomReceiveTransactionCreate a créé l’objet custom-receive-transaction, cet objet existe pendant la durée de vie de l’objet d’appareil framework qui représente l’appareil de contrôleur série.
L’objet custom-receive-transaction est automatiquement supprimé lorsque l’objet d’appareil est supprimé.
Le pilote de contrôleur série ne doit pas essayer de supprimer l’objet custom-receive-transaction en appelant une méthode telle que WdfObjectDelete.
Un pilote de contrôleur série peut, en option, créer un objet de transaction de réception personnalisée, mais ne peut pas créer plus d’un objet de ce type.
Le pilote peut créer cet objet uniquement dans les conditions suivantes :</wdcml:p>
- Le pilote a précédemment créé un objet PIO-receive.
- Le pilote a précédemment créé un objet de réception personnalisé.
Pour plus d’informations sur les objets PIO-receive, consultez SERCX2PIORECEIVE Object Handle. Pour plus d’informations sur les objets de réception personnalisés, consultez SERCX2CUSTOMRECEIVE Object Handle.
Malgré les durées de vie similaires des objets de réception personnalisée et de réception personnalisée-transaction, ceux-ci sont définis en tant que types d’objets distincts (et non combinés en un seul type) pour prendre en charge l’extension future possible de l’interface du pilote de périphérique SerCx2.
SERCX2CUSTOMTRANSMIT Object Handle
Un handle d’objet SERCX2CUSTOMTRANSMIT est une référence opaque à un objet de transmission personnalisée dans la version 2 de l’extension de framework série (SerCx2).
La méthode SerCx2CustomTransmitCreate crée un objet de transmission personnalisée.h SerCx2 utilise cet objet pour gérer les transactions d’E/S qui écrivent des données dans le contrôleur série. Cet objet est opaque pour les pilotes de contrôleur série.
SerCx2CustomTransmitCreate fournit, en tant que paramètre de sortie, un handle SERCX2CUSTOMTRANSMIT à l’objet de transmission personnalisée nouvellement créé. SerCx2 et le pilote de contrôleur série utilisent ce handle pour faire référence à l’objet dans les appels suivants aux méthodes SerCx2 et aux fonctions de rappel d’événement.
Une fois que SerCx2CustomTransmitCreate a créé l’objet de transmission personnalisée, cet objet existe pendant la durée de vie de l’objet d’appareil framework qui représente l’appareil de contrôleur série.
L’objet de transmission personnalisée est automatiquement supprimé lorsque l’objet d’appareil est supprimé. Le pilote de contrôleur série ne doit pas essayer de supprimer l’objet de transmission personnalisée en appelant une méthode telle que WdfObjectDelete.
Un pilote de contrôleur série peut, en option, créer un objet de transmission personnalisée, mais ne peut pas créer plusieurs objets de ce type.
Le pilote peut créer cet objet uniquement dans les conditions suivantes :
- Le pilote a précédemment créé un objet de transmission PIO.
- Le pilote n’a pas créé d’objet de transmission system-DMA.
Pour plus d’informations sur les objets PIO-transmit, consultez SERCX2PIOTRANSMIT Object Handle. Pour plus d’informations sur les objets system-DMA-transmit, consultez SERCX2SYSTEMDMATRANSMIT Object Handle.
SERCX2CUSTOMTRANSMITTRANSACTION Object Handle
Un handle d’objet SERCX2CUSTOMTRANSMITTRANSACTION est une référence opaque à un objet de transaction de transmission personnalisée dans la version 2 de l’extension d’infrastructure série (SerCx2).
La méthode SerCx2CustomTransmitTransactionCreate crée un objet de transaction de transmission personnalisée. SerCx2 utilise cet objet pour gérer les transactions d’E/S qui utilisent un mécanisme de transfert de données personnalisé pour écrire des données dans le contrôleur série. Cet objet est opaque pour les pilotes de contrôleur série.
SerCx2CustomTransmitTransactionCreate fournit, en tant que paramètre de sortie, un handle SERCX2CUSTOMTRANSMITTRANSACTION à l’objet custom-transmit-transaction nouvellement créé. SerCx2 et le pilote de contrôleur série utilisent ce handle pour faire référence à l’objet dans les transactions de transmission personnalisée suivantes.
Pour plus d’informations, consultez Transactions SerCx2 Custom-Transmit.
Une fois que SerCx2CustomTransmitTransactionCreate a créé l’objet custom-transmit-transaction, cet objet existe pendant la durée de vie de l’objet d’appareil framework qui représente l’appareil de contrôleur série. L’objet de transaction de transmission personnalisée est automatiquement supprimé lorsque l’objet d’appareil est supprimé. Le pilote de contrôleur série ne doit pas essayer de supprimer l’objet de transaction de transmission personnalisée en appelant une méthode telle que WdfObjectDelete.
Un pilote de contrôleur série peut, en option, créer un objet de transmission personnalisée, mais ne peut pas créer plusieurs objets de ce type. Le pilote peut créer cet objet uniquement dans les conditions suivantes :
- Le pilote a précédemment créé un objet de transmission PIO.
- Le pilote n’a pas créé d’objet de transmission system-DMA.
Pour plus d’informations sur les objets PIO-transmit, consultez SERCX2PIOTRANSMIT Object Handle. Pour plus d’informations sur les objets de transmission personnalisée, consultez SERCX2CUSTOMTRANSMIT Object Handle.
Malgré les durées de vie similaires des objets de transmission personnalisée et de transmission personnalisée-transaction, ceux-ci sont définis en tant que types d’objets distincts (et non combinés en un seul type) pour prendre en charge l’extension future possible de l’interface du pilote de périphérique SerCx2.
SERCX2PIORECEIVE, handle d’objet
Un handle d’objet SERCX2PIORECEIVE est une référence opaque à un objet de réception PIO dans la version 2 de l’extension de framework série (SerCx2).
La méthode SerCx2PioReceiveCreate crée un objet PIO-receive. SerCx2 utilise un objet pour gérer les transactions d’E/S programmées (PIO) qui lisent les données du contrôleur série. Cet objet est opaque pour les pilotes de contrôleur série. fournit, en tant que paramètre de sortie, un handle SERCX2PIORECEIVE à l’objet PIO-receive nouvellement créé. SerCx2 et le pilote de contrôleur série utilisent ce handle pour faire référence à l’objet dans les transactions de réception PIO suivantes.
Pour plus d’informations, consultez Transactions SerCx2 PIO-Receive. Une fois que SerCx2PioReceiveCreate a créé l’objet PIO-receive, cet objet existe pendant la durée de vie de l’objet d’appareil framework qui représente l’appareil de contrôleur série. L’objet PIO-receive est automatiquement supprimé lorsque l’objet d’appareil est supprimé. Le pilote de contrôleur série ne doit pas essayer de supprimer l’objet PIO-receive en appelant une méthode telle que WdfObjectDelete.
Un pilote de contrôleur série doit créer un seul objet de réception PIO. Le pilote doit créer cet objet avant de créer un objet system-DMA-receive ou un objet de réception personnalisé. Pour plus d’informations sur les objets system-DMA-receive, consultez SERCX2SYSTEMDMARECEIVE Object Handle. Pour plus d’informations sur les objets de réception personnalisés, consultez SERCX2CUSTOMRECEIVE Object Handle.
Handle d’objet SERCX2PIOTRANSMIT
Un handle d’objet SERCX2PIOTRANSMIT est une référence opaque à un objet de transmission PIO dans la version 2 de l’extension d’infrastructure série (SerCx2).
La méthode SerCx2PioTransmitCreate crée un objet de transmission PIO. SerCx2 utilise cet objet pour gérer les transactions d’E/S qui utilisent des E/S programmées (PIO) pour écrire des données dans le contrôleur série. Cet objet est opaque aux pilotes de contrôleur série. SerCx2PioTransmitCreate fournit, en tant que paramètre de sortie, un handle SERCX2PIOTRANSMIT à l’objet PIO-transmit nouvellement créé. SerCx2 et le pilote de contrôleur série utilisent ce handle pour faire référence à l’objet dans les transactions de transmission PIO suivantes. Pour plus d’informations, consultez Transactions PIO-Transmit SerCx2. Une fois que SerCx2PioTransmitCreate a créé l’objet PIO-transmit, cet objet existe pendant la durée de vie de l’objet d’appareil framework qui représente le périphérique de contrôleur série. L’objet PIO-transmit est automatiquement supprimé lorsque l’objet d’appareil est supprimé. Le pilote du contrôleur série ne doit pas essayer de supprimer l’objet PIO-transmit en appelant une méthode telle que WdfObjectDelete.
Un pilote de contrôleur série doit créer un seul objet de transmission PIO. Le pilote doit créer cet objet avant de créer un objet de transmission DMA système ou un objet de transmission personnalisé. Pour plus d’informations sur les objets system-DMA-transmit, consultez SERCX2SYSTEMDMATRANSMIT Object Handle. Pour plus d’informations sur les objets de transmission personnalisée, consultez SERCX2CUSTOMTRANSMIT Object Handle.
SERCX2SYSTEMDMARECEIVE, handle d’objet
Un handle d’objet SERCX2SYSTEMDMARECEIVE est une référence opaque à un objet system-DMA-receive dans la version 2 de l’extension d’infrastructure série (SerCx2).
La méthode SerCx2SystemDmaReceiveCreate crée un objet system-DMA-receive. SerCx2 utilise cet objet pour gérer les transactions DMA système qui lisent les données du contrôleur série. Cet objet est opaque aux pilotes de contrôleur série. SerCx2SystemDmaReceiveCreate fournit, en tant que paramètre de sortie, un handle SERCX2SYSTEMDMARECEIVE à l’objet system-DMA-receive nouvellement créé. SerCx2 et le pilote de contrôleur série utilisent ce handle pour faire référence à l’objet dans les transactions système-DMA-receive suivantes. Pour plus d’informations, consultez Transactions SerCx2 System-DMA-Receive.
Une fois que SerCx2SystemDmaReceiveCreate a créé l’objet system-DMA-receive, cet objet existe pendant la durée de vie de l’objet d’appareil framework qui représente l’appareil de contrôleur série. L’objet system-DMA-receive est automatiquement supprimé lorsque l’objet d’appareil est supprimé. Un pilote de contrôleur série peut, en option, créer un objet system-DMA-receive, mais ne peut pas créer plus d’un objet de ce type. Le pilote peut créer cet objet uniquement dans les conditions suivantes :
- Le pilote a précédemment créé un objet PIO-receive.
- Le pilote n’a pas créé d’objet de réception personnalisé.
Pour plus d’informations sur les objets PIO-receive, consultez SERCX2PIORECEIVE Object Handle. Pour plus d’informations sur les objets custom-receive, consultez SERCX2CUSTOMRECEIVE Object Handle.
SERCX2SYSTEMDMATRANSMIT, handle d’objet
Un handle d’objet SERCX2SYSTEMDMATRANSMIT est une référence opaque à un objet de transmission DMA système dans la version 2 de l’extension d’infrastructure série (SerCx2).
La méthode SerCx2SystemDmaTransmitCreate crée un objet system-DMA-transmit. SerCx2 utilise cet objet pour gérer les transactions DMA système qui écrivent des données dans le contrôleur série. Cet objet est opaque aux pilotes de contrôleur série. SerCx2SystemDmaTransmitCreate fournit, en tant que paramètre de sortie, un handle SERCX2SYSTEMDMATRANSMIT à l’objet system-DMA-transmit nouvellement créé. SerCx2 et le pilote de contrôleur série utilisent ce handle pour faire référence à l’objet dans les transactions de transmission système-DMA suivantes. Pour plus d’informations, consultez Transactions SerCx2 System-DMA-Transmit.
Une fois que SerCx2SystemDmaTransmitCreate a créé l’objet system-DMA-transmit, cet objet existe pendant la durée de vie de l’objet d’appareil framework qui représente le périphérique de contrôleur série. L’objet system-DMA-transmit est automatiquement supprimé lorsque l’objet d’appareil est supprimé. Le pilote du contrôleur série ne doit pas essayer de supprimer l’objet system-DMA-transmit en appelant une méthode telle que WdfObjectDelete.
Un pilote de contrôleur série peut, en option, créer un objet de transmission système DMA, mais ne peut pas créer plus d’un objet de ce type. Le pilote peut créer cet objet uniquement dans les conditions suivantes :</wdcml:p>
- Le pilote a précédemment créé un objet de transmission PIO.
- Le pilote n’a pas créé d’objet de transmission personnalisée.
Pour plus d’informations sur les objets PIO-transmit, consultez SERCX2PIOTRANSMIT Object Handle. Pour plus d’informations sur les objets de transmission personnalisée, consultez SERCX2CUSTOMTRANSMIT Object Handle.
Rubriques connexes
SerCx2 Custom-Receive Transactions
SerCx2 Custom-Transmit Transactions
SerCx2 PIO-Receive Transactions
SerCx2 PIO-Transmit Transactions
SerCx2 System-DMA-Receive Transactions
Transactions de transmission système DMA SerCx2
SerCx2CustomReceiveTransactionCreate
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour