SerCx2CustomReceiveCreate, fonction (sercx.h)
La méthode SerCx2CustomReceiveCreate crée un objet custom-receive, que la version 2 de l’extension d’infrastructure série (SerCx2) utilise pour lire les données de réception du contrôleur série au moyen d’un mécanisme de transfert de données personnalisé.
Syntaxe
NTSTATUS SerCx2CustomReceiveCreate(
[in] WDFDEVICE Device,
[in] PSERCX2_CUSTOM_RECEIVE_CONFIG CustomReceiveConfig,
[in] PWDF_OBJECT_ATTRIBUTES Attributes,
[out] SERCX2CUSTOMRECEIVE *CustomReceive
);
Paramètres
[in] Device
Un handle WDFDEVICE pour l’objet d’appareil framework qui représente le contrôleur série. Le pilote du contrôleur série a créé cet objet dans sa fonction de rappel EvtDriverDeviceAdd . Pour plus d’informations, consultez SerCx2InitializeDevice.
[in] CustomReceiveConfig
Pointeur vers une structure SERCX2_CUSTOM_RECEIVE_CONFIG . Avant d’appeler cette méthode, l’appelant doit appeler la fonction SERCX2_CUSTOM_RECEIVE_CONFIG_INIT pour initialiser la structure. Cette structure contient des pointeurs vers un ensemble de routines de rappel d’événements implémentées par le pilote de contrôleur série. SerCx2 appelle ces fonctions pour effectuer des transactions de réception personnalisées.
[in] Attributes
Pointeur vers une structure WDF_OBJECT_ATTRIBUTES qui décrit les attributs à affecter au nouvel objet custom-receive. Avant d’appeler cette méthode, l’appelant doit appeler la fonction WDF_OBJECT_ATTRIBUTES_INIT pour initialiser la structure. Ce paramètre est facultatif et peut être spécifié en tant que WDF_NO_OBJECT_ATTRIBUTES si le pilote de contrôleur série n’a pas besoin d’affecter des attributs à l’objet. Pour plus d'informations, consultez la section Notes.
[out] CustomReceive
Pointeur vers un emplacement dans lequel cette méthode écrit un handle de SERCX2CUSTOMRECEIVE dans l’objet custom-receive nouvellement créé. SerCx2 et le pilote de contrôleur série utilisent ce handle dans les appels suivants pour faire référence à cet objet.
Valeur retournée
Cette méthode retourne STATUS_SUCCESS si l’appel réussit. Les valeurs de retour d’erreur possibles incluent les codes status suivants.
Code de retour | Description |
---|---|
|
Un objet custom-receive existe déjà à partir d’un appel SerCx2CustomReceiveCreate précédent ; ou un objet system-DMA-receive existe à partir d’un appel SerCx2CustomReceiveCreate précédent ; ou un objet system-DMA-transmit existe à partir d’un appel SerCx2CustomTransmitCreate précédent ; ou SerCx2PioReceiveCreate n’a pas encore été appelé pour créer un objet PIO-receive. |
|
Une valeur de paramètre n’est pas valide. |
|
->La valeurTaille de configuration n’est pas égale à sizeof(SERCX2_CUSTOM_RECEIVE_CONFIG). |
|
Les ressources disponibles sont insuffisantes pour créer l’objet custom-receive. |
Remarques
Cette méthode est appelée par le pilote de contrôleur série pour créer un objet de réception personnalisé. SerCx2 utilise cet objet pour effectuer des transactions de réception personnalisées, qui sont des transactions qui utilisent un mécanisme de transfert de données personnalisé pour lire les données reçues par le contrôleur série.
Un pilote de contrôleur série doit appeler correctement les méthodes SerCx2InitializeDevice et SerCx2PioReceiveCreate avant d’appeler SerCx2CustomReceiveCreate.
Avant d’appeler SerCx2CustomReceiveCreate, le pilote de contrôleur série doit appeler la fonction SERCX2_CUSTOM_RECEIVE_CONFIG_INIT pour initialiser la structure SERCX2_CUSTOM_RECEIVE_CONFIG pointée par CustomReceiveConfig. Cette fonction définit les membres suivants de la structure sur zéro :
- Alignment
- MinimumTransactionLength
- MaximumTransactionLength
- MinimumTransferUnit
- Exclusif
- Si l’alignement est égal à zéro, SerCx2 définit la valeur d’alignement des données sur 1, ce qui signifie que la mémoire tampon de lecture peut démarrer sur une limite d’octets arbitraire en mémoire.
- Si MinimumTransactionLength est égal à zéro, SerCx2 définit la longueur minimale de transaction sur un octet.
- Si MaximumTransactionLength est égal à zéro, SerCx2 définit la longueur maximale de transaction sur ((ULONG)-1).
- Si MinimumTransferUnit est égal à zéro, SerCx2 définit l’unité de transfert minimale sur un octet.
- Si Exclusive a la valeur zéro (FALSE), le mode exclusif est désactivé.
En option, un pilote de contrôleur série peut utiliser le paramètre Attributes pour créer un contexte pour l’objet custom-receive et pour fournir des pointeurs vers les fonctions EvtCleanupCallback et EvtDestroyCallback appelées pour préparer l’objet en vue de la suppression. Pour plus d’informations, consultez WDF_OBJECT_ATTRIBUTES.
Si le paramètre Attributes pointe vers une structure WDF_OBJECT_ATTRIBUTES , l’appelant ne doit pas remplacer les valeurs que la fonction d’initialisation WDF_OBJECT_ATTRIBUTES_INIT écrit sur les membres ParentObject, ExecutionLevel et SynchronizationScope de cette structure.
Pour plus d’informations sur la création d’objets de réception personnalisés, consultez SERCX2CUSTOMRECEIVE. Pour plus d’informations sur les transactions de réception personnalisées, consultez Transactions SerCx2 Custom-Receive.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Disponible à partir de Windows 8.1. |
Plateforme cible | Universal |
En-tête | sercx.h |
IRQL | PASSIVE_LEVEL |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
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, consultezEnvoyer et afficher des commentaires pour