Partager via

SpbDeviceInitialize, fonction (spbcx.h)

  • Article

La méthode SpbDeviceInitialize termine l’initialisation du pilote de contrôleur SPB après que ce pilote a créé l’objet de périphérique associé.

Syntaxe

NTSTATUS SpbDeviceInitialize(
  [in] WDFDEVICE              FxDevice,
  [in] PSPB_CONTROLLER_CONFIG Config
);

Paramètres

[in] FxDevice

Un handle WDFDEVICE pour l’objet d’appareil qui représente le contrôleur SPB.

[in] Config

Pointeur vers une structure de SPB_CONTROLLER_CONFIG qui contient les informations de configuration du périphérique pour le pilote de contrôleur SPB. Cette structure doit avoir été initialisée par la fonction SPB_CONTROLLER_CONFIG_INIT .

Valeur retournée

SpbDeviceInitialize retourne STATUS_SUCCESS si elle réussit. Sinon, elle retourne un code d’erreur NTSTATUS approprié.

Remarques

Votre pilote de contrôleur SPB appelle cette méthode pour inscrire ses fonctions de rappel d’événements auprès de l’extension SPB Framework (SpbCx) et pour spécifier le mode de transfert à utiliser pour la file d’attente d’E/S du contrôleur. SpbDeviceInitialize crée toutes les structures de données internes du contrôleur, y compris la file d’attente d’E/S.

Le pilote du contrôleur SPB doit appeler cette méthode avant de valider l’objet de périphérique, c’est-à-dire avant qu’il ne retourne à partir du rappel EvtDriverDeviceAdd ou qu’il ajoute l’ADO à la liste enfant du contrôleur. La liste enfant représente les appareils qui sont attachés au bus. Pour plus d’informations, consultez Énumération des appareils sur un bus.

Une fois que SpbDeviceInitialize est retourné, le contrôleur est prêt à traiter les demandes d’E/S, mais le pilote du contrôleur SPB peut, si nécessaire, continuer à configurer les paramètres du contrôleur avant de valider l’objet d’appareil.

Si la structure pointée par Config n’est pas remplie correctement, driver Verifier génère une erreur. Pour plus d’informations sur la configuration requise pour le paramètre Config , consultez SPB_CONTROLLER_CONFIG.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible à partir de Windows 8.
Plateforme cible Universal
En-tête spbcx.h
Bibliothèque Spbcxstubs.lib
IRQL PASSIVE_LEVEL

Voir aussi

EvtChildListCreateDevice

EvtDriverDeviceAdd

SPB_CONTROLLER_CONFIG

SPB_CONTROLLER_CONFIG_INIT