SpbDeviceInitialize, fonction (spbcx.h)
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 |