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 |