Partager via


SpbDeviceInitialize, fonction (spbcx.h)

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

Syntaxe

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

Paramètres

[in] FxDevice

Handle WDFDEVICE sur l’objet d’appareil qui représente le contrôleur SPB.

[in] Config

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

Valeur de retour

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 de l’infrastructure SPB (SpbCx) et 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 qu’elle n'valide l’objet d’appareil, autrement dit, avant de retourner à partir de la EvtDriverDeviceAdd rappel ou ajoute l’objet PDO à la liste enfant du contrôleur. La liste enfant représente les appareils attachés au bus. Pour plus d’informations, consultez énumération des appareils sur un bus.

Une fois SpbDeviceInitialize 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 configuration n’est pas remplie correctement, vérificateur de pilote génère une erreur. Pour plus d’informations sur la configuration requise pour le paramètre config, consultez SPB_CONTROLLER_CONFIG.

Exigences

Exigence Valeur
client minimum pris en charge Disponible à partir de Windows 8.
plateforme cible Universel
d’en-tête spbcx.h
bibliothèque Spbcxstubs.lib
IRQL PASSIVE_LEVEL

Voir aussi

EvtChildListCreateDevice

EvtDriverDeviceAdd

SPB_CONTROLLER_CONFIG

SPB_CONTROLLER_CONFIG_INIT