BdaStartChanges-Funktion (bdasup.h)

Artikel
02/22/2024

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

Syntax

NTSTATUS BdaStartChanges(
  [in] PIRP pIrp
);

Parameter

[in] pIrp

Verweist auf den IRP für die Anforderung zum Initiieren von Änderungen. Der BDA-Minidriver empfängt diese IRP mit der KSMETHOD_BDA_START_CHANGES Anforderung.

Rückgabewert

Gibt STATUS_SUCCESS oder einen entsprechenden Fehlercode zurück.

Hinweise

Ein BDA-Minidriver ruft die BdaStartChanges-Funktion auf, um die Einstellung neuer BDA-Topologieänderungen zu initiieren, nachdem der Minitreiber eine KSMETHOD_BDA_START_CHANGES Anforderung des KSMETHODSETID_BdaChangeSync Methodensatzes vom Netzwerkanbieter empfangen hat. BDA-Minidriver definieren Dispatch- und Filterautomatisierungstabellen, sodass diese Minidriver entweder die BdaStartChanges-Funktion direkt senden oder diese Anforderung mithilfe einer internen Methode (KStrMethodHandler) abfangen, die dann die BdaStartChanges-Funktion aufruft . BDA-Minitreiber, die diese Anforderung abfangen, können beispielsweise einen Zeiger auf den BDA-Filter aus dem übergebenen IRP abrufen, damit sie ausstehende Filterressourcen anschließend 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 .

Wenn Sie die BdaStartChanges-Funktion aufrufen, werden alle zuvor angeforderten Topologieänderungen ignoriert, für die noch kein Commit ausgeführt wurde.