SerCxInitialize, fonction (sercx.h)
La méthode SerCxInitialize termine l’initialisation de l’extension d’infrastructure série (SerCx) une fois 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
Handle WDFDEVICE pour l’objet d’appareil framework qui représente le contrôleur série.
[in] Config
Pointeur vers une structure SERCX_CONFIG allouée par 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 de retour
SerCxInitialize retourne STATUS_SUCCESS si elle réussit. Les valeurs de retour d’erreur possibles incluent les codes d’état suivants.
| Retourner le code | Description |
|---|---|
|
La méthode a été appelée au mauvais IRQL ; ou le handle WDFDEVICE n’est pas valide ; ou FxDevice ou Configuration est NULL. |
|
Impossible d’allouer des ressources système (généralement de la mémoire). |
Remarques
Le pilote de contrôleur série appelle cette méthode après avoir créé l’objet d’appareil associé.
SerCxInitialize inscrit les fonctions de rappel d’E/S du pilote de contrôleur avec 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 du contrôleur peut configurer les paramètres matériels du contrôleur avant qu’il ne retourne à partir de l'EvtDriverDeviceAdd rappel ou avant d’ajouter la fonction PDO à la liste enfant.
Si les paramètres ne sont pas valides (comme décrit dans SERCX_CONFIG), vérificateur de pilote génère une erreur.
Cette routine doit être appelée avant de valider l’appareil (en retournant de EvtDriverDeviceAdd ou en ajoutant l’application PDO à la liste enfant).
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows 8. |
| plateforme cible | Universel |
| d’en-tête | sercx.h |
| IRQL | PASSIVE_LEVEL |