BdaGetChangeState, fonction (bdasup.h)
La fonction BdaGetChangeState retourne l’état de modification actuel de la topologie BDA.
Syntaxe
NTSTATUS BdaGetChangeState(
[in] PIRP pIrp,
[out, optional] PBDA_CHANGE_STATE pChangeState
);
Paramètres
[in] pIrp
Pointe vers l’IRP de la demande pour obtenir l’état de modification actuel. Le minidriver BDA reçoit cet IRP avec la demande de KSMETHOD_BDA_GET_CHANGE_STATE.
[out, optional] pChangeState
Pointe vers une variable qui reçoit l’état de modification actuel de la topologie BDA. L’état de modification BDA peut être l’une des valeurs suivantes du type énuméré BDA_CHANGE_STATE :
| Valeur | Description |
|---|---|
| BDA_CHANGES_COMPLETE | Les modifications de topologie BDA sont terminées. |
| BDA_CHANGES_PENDING | Les modifications de topologie BDA sont en attente. |
Valeur de retour
Retourne STATUS_SUCCESS ou un code d’erreur approprié.
Remarques
Un minidriver BDA appelle la fonction BdaGetChangeState pour récupérer l’état de modification actuel de la topologie BDA une fois que le minidriver reçoit une requête KSMETHOD_BDA_GET_CHANGE_STATE de la méthode KSMETHODSETID_BdaChangeSync définie à partir du fournisseur réseau. Les minidrivers BDA définissent des tables de répartition et d’automatisation des filtres afin que ces minidrivers distribuent directement la fonction BdaGetChangeState ou interceptent cette requête à l’aide d’une méthode interne (KStrMethodHandler), qui appelle ensuite la fonction BdaGetChangeState. Par exemple, les mini-drivers BDA qui interceptent cette requête peuvent obtenir un pointeur vers le filtre BDA à partir de l’IRP passé afin qu’ils puissent :
Vérifiez non seulement les modifications de topologie en attente, mais également les modifications en attente sur le filtre.
Retournez l’état actuel des modifications pour la topologie BDA et le filtre BDA.
Pour plus d’informations, consultez Définition des tables Automation et modification des propriétés de filtre BDA.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | bdasup.h (include Bdasup.h) |
| bibliothèque | Bdasup.lib |
| IRQL | PASSIVE_LEVEL |