Fonction BdaGetChangeState (bdasup.h)

Article
02/26/2024

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 pour la demande d’obtention de 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 BDA_CHANGE_STATE énuméré :

Valeur	Description
BDA_CHANGES_COMPLETE	Les modifications de la topologie BDA sont terminées.
BDA_CHANGES_PENDING	Les modifications de topologie BDA sont en attente.

Valeur retournée

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 après que le minidriver a reçu une demande KSMETHOD_BDA_GET_CHANGE_STATE de la méthode KSMETHODSETID_BdaChangeSync définie du fournisseur réseau. Les mini-disques 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 demande peuvent obtenir un pointeur vers le filtre BDA à partir de l’IRP passé afin qu’ils puissent :

Non seulement case activée pour les modifications de topologie en attente, mais également pour les modifications en attente sur le filtre.
Retourne l’état de modification actuel pour la topologie BDA et le filtre BDA.

Pour plus d’informations, consultez Définition de tables Automation et Modification des propriétés de filtre BDA .