BdaStartChanges-Funktion (bdasup.h)

Die BdaStartChanges--Funktion initiiert die Einstellung neuer BDA-Topologieänderungen.

Syntax

NTSTATUS BdaStartChanges(
  [in] PIRP pIrp
);

Parameter

[in] pIrp

Verweist auf das IRP für die Anforderung, Änderungen zu initiieren. Der BDA-Minidriver empfängt dieses IRP mit der KSMETHOD_BDA_START_CHANGES Anforderung.

Rückgabewert

Gibt STATUS_SUCCESS oder einen entsprechenden Fehlercode zurück.

Bemerkungen

Ein BDA-Minidriver ruft die BdaStartChanges--Funktion auf, um die Einstellung neuer BDA-Topologieänderungen zu initiieren, nachdem der Minidriver eine KSMETHOD_BDA_START_CHANGES Anforderung der vom Netzwerkanbieter festgelegten KSMETHODSETID_BdaChangeSync-Methode empfängt. BDA-Minidriver definieren Verteiler- und Filterautomatisierungstabellen, sodass diese Minidriver entweder die BdaStartChanges funktion direkt verteilen oder diese Anforderung mithilfe einer internen Methode (KStrMethodHandler) abfangen, die dann die BdaStartChanges-Funktion aufruft. Beispielsweise können BDA-Minidriver, die diese Anforderung abfangen, einen Zeiger auf den BDA-Filter aus dem übergebenen IRP abrufen, sodass sie anschließend ausstehende Filterressourcen auf die neuen Anforderungen zurücksetzen und den Änderungsstatus des Filters auf BDA_CHANGES_COMPLETE festlegen können. Weitere Informationen finden Sie unter Definieren von Automatisierungstabellen und Ändern von BDA-Filtereigenschaften.

Das Aufrufen der BdaStartChanges--Funktion bewirkt, dass zuvor angeforderte Topologieänderungen, die noch nicht ignoriert wurden, ignoriert werden.

Anforderungen

Siehe auch

BDA_CHANGE_STATE

BdaCommitChanges

KSMETHODSETID_BdaChangeSync

KSMETHOD_BDA_START_CHANGES

KStrMethodHandler-