BdaGetChangeState-Funktion (bdasup.h)

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

Syntax

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

Parameter

[in] pIrp

Verweist auf das IRP für die Anforderung, um den aktuellen Änderungsstatus abzurufen. Der BDA-Minidriver empfängt dieses 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-Änderungsstatus kann einer der folgenden Werte aus dem BDA_CHANGE_STATE Enumerationstyp sein:

Rückgabewert

Gibt STATUS_SUCCESS oder einen entsprechenden Fehlercode zurück.

Bemerkungen

Ein BDA-Minidriver ruft die BdaGetChangeState-Funktion auf, um den aktuellen Änderungszustand der BDA-Topologie abzurufen, nachdem der Minidriver eine KSMETHOD_BDA_GET_CHANGE_STATE Anforderung der vom Netzwerkanbieter festgelegten KSMETHODSETID_BdaChangeSync-Methode empfängt. BDA-Minidriver definieren Verteiler- und Filterautomatisierungstabellen, sodass diese Minidriver entweder die BdaGetChangeState Funktion direkt verteilen oder diese Anforderung mithilfe einer internen Methode (KStrMethodHandler) abfangen, die dann die BdaGetChangeState-Funktion aufruft. Beispielsweise können BDA-Minidriver, die diese Anforderung abfangen, einen Zeiger auf den BDA-Filter aus dem übergebenen IRP abrufen, damit sie:

• Überprüfen Sie nicht nur auf ausstehende Topologieänderungen, sondern auch auf ausstehende Änderungen für den 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.

Anforderungen

Siehe auch

BDA_CHANGE_STATE

KSMETHODSETID_BdaChangeSync

KSMETHOD_BDA_GET_CHANGE_STATE

KStrMethodHandler-