Partager via

SerCxInitialize, fonction (sercx.h)

  • Article

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
STATUS_INVALID_DEVICE_REQUEST
 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.
STATUS_INSUFFICIENT_RESOURCES
 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

Voir aussi

EvtDriverDeviceAdd

SERCX_CONFIG

SERCX_CONFIG_INIT