SerCxInitialize, fonction (sercx.h)
La méthode SerCxInitialize termine l’initialisation de l’extension d’infrastructure série (SerCx) après que ce pilote a créé l’objet de périphérique associé.
Syntaxe
NTSTATUS SerCxInitialize(
[in] WDFDEVICE FxDevice,
[in] PSERCX_CONFIG Config
);
Paramètres
[in] FxDevice
Un handle WDFDEVICE pour l’objet d’appareil framework qui représente le contrôleur série.
[in] Config
Pointeur vers une structure de SERCX_CONFIG allouée à l’appelant qui contient des informations de configuration pour SerCx. L’appelant a précédemment appelé la fonction SERCX_CONFIG_INIT pour initialiser cette structure.
Valeur retournée
SerCxInitialize retourne STATUS_SUCCESS si elle réussit. Les valeurs de retour d’erreur possibles incluent les codes status suivants.
| Code de retour | Description |
|---|---|
|
La méthode a été appelée au niveau de l’IRQL incorrect ; ou le handle WDFDEVICE n’est pas valide ; ou FxDevice ou Config a la valeur NULL. |
|
Impossible d’allouer des ressources système (généralement de la mémoire). |
Remarques
Le pilote du contrôleur série appelle cette méthode après avoir créé l’objet de périphérique associé.
SerCxInitialize inscrit les fonctions de rappel d’E/S du pilote de contrôleur auprès de SerCx. En outre, cette méthode définit le mode de transfert pour la file d’attente d’E/S. Pendant l’appel, cette méthode crée toutes les structures internes requises par SerCx (y compris la file d’attente d’E/S pour le contrôleur série). Une fois cette méthode retournée, SerCx est prêt à traiter les E/S. Toutefois, le pilote de contrôleur peut configurer les paramètres matériels du contrôleur avant qu’il ne retourne à partir du rappel EvtDriverDeviceAdd ou avant d’ajouter l’ADO à la liste enfant.
Si les paramètres ne sont pas valides (comme décrit dans SERCX_CONFIG), le vérificateur de pilote génère une erreur.
Cette routine doit être appelée avant de valider l’appareil (retour à partir d’EvtDriverDeviceAdd ou ajout de l’AOP à la liste enfant).
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible à partir de Windows 8. |
| Plateforme cible | Universal |
| En-tête | sercx.h |
| IRQL | PASSIVE_LEVEL |