BdaGetChangeState-Funktion (bdasup.h)

Artikel
02/22/2024

Die BdaGetChangeState-Funktion gibt den aktuellen Änderungszustand der BDA-Topologie zurück.

Syntax

NTSTATUS BdaGetChangeState(
  [in]            PIRP              pIrp,
  [out, optional] PBDA_CHANGE_STATE pChangeState
);

Parameter

[in] pIrp

Verweist auf den IRP für die Anforderung, um den aktuellen Änderungsstatus zu erhalten. Der BDA-Minidriver empfängt diese IRP mit der KSMETHOD_BDA_GET_CHANGE_STATE Anforderung.

[out, optional] pChangeState

Verweist auf eine Variable, die den aktuellen Änderungsstatus der BDA-Topologie empfängt. Der BDA-Änderungszustand kann einer der folgenden Werte aus dem BDA_CHANGE_STATE aufgezählten Typ sein:

Wert	BESCHREIBUNG
BDA_CHANGES_COMPLETE	Änderungen an der BDA-Topologie sind abgeschlossen.
BDA_CHANGES_PENDING	Änderungen an der BDA-Topologie stehen aus.

Rückgabewert

Gibt STATUS_SUCCESS oder einen entsprechenden Fehlercode zurück.

Hinweise

Ein BDA-Minidriver ruft die BdaGetChangeState-Funktion auf, um den aktuellen Änderungszustand der BDA-Topologie abzurufen, nachdem der Minitreiber eine KSMETHOD_BDA_GET_CHANGE_STATE Anforderung des KSMETHODSETID_BdaChangeSync Methodensatzes vom Netzwerkanbieter empfangen hat. BDA-Minidriver definieren Dispatch- und Filterautomatisierungstabellen, sodass diese Minidriver entweder die BdaGetChangeState-Funktion direkt senden oder diese Anforderung mithilfe einer internen Methode (KStrMethodHandler) abfangen, die dann die BdaGetChangeState-Funktion aufruft. BDA-Minitreiber, die diese Anforderung abfangen, können beispielsweise einen Zeiger auf den BDA-Filter aus dem übergebenen IRP abrufen, sodass sie:

Überprüfen Sie nicht nur auf ausstehende Topologieänderungen, sondern auch auf ausstehende Änderungen am Filter.
Gibt den aktuellen Änderungsstatus sowohl für die BDA-Topologie als auch für den BDA-Filter zurück.

Weitere Informationen finden Sie unter Definieren von Automatisierungstabellen und Ändern von BDA-Filtereigenschaften .