BdaCommitChanges-Funktion (bdasup.h)
Die BdaCommitChanges-Funktion committet die Änderungen an der BDA-Topologie, die seit dem letzten Aufruf der BdaStartChanges-Funktion aufgetreten sind.
Syntax
NTSTATUS BdaCommitChanges(
[in] PIRP pIrp
);
Parameter
[in] pIrp
Verweist auf den IRP für die Anforderung zum Commit von Änderungen. Der BDA-Minidriver empfängt diese IRP mit der KSMETHOD_BDA_COMMIT_CHANGES Anforderung.
Rückgabewert
Gibt STATUS_SUCCESS oder einen entsprechenden Fehlercode zurück.
Hinweise
Ein BDA-Minidriver ruft die BdaCommitChanges-Funktion auf, um eine Reihe von BDA-Topologieänderungen zu committen, nachdem der Minitreiber eine KSMETHOD_BDA_COMMIT_CHANGES Anforderung des KSMETHODSETID_BdaChangeSync Methodensatzes vom Netzwerkanbieter empfangen hat. BDA-Minidriver definieren Dispatch- und Filterautomatisierungstabellen, sodass diese Minidriver entweder die BdaCommitChanges-Funktion direkt senden oder diese Anforderung mithilfe einer internen Methode (KStrMethodHandler) abfangen, die dann die BdaCommitChanges-Funktion aufruft . BDA-Minitreiber, die diese Anforderung abfangen, können beispielsweise einen Zeiger auf den BDA-Filter aus dem übergebenen IRP abrufen, sodass sie:
Legen Sie die neue Liste der Ressourcen für den Filter auf die ausstehende Liste der Ressourcen fest.
Legen Sie den Änderungsstatus des Filters auf BDA_CHANGES_COMPLETE fest.
Committen Sie die Ressourcen auf dem zugrunde liegenden Gerät.
Weitere Informationen finden Sie unter Definieren von Automatisierungstabellen und Ändern von BDA-Filtereigenschaften .
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar unter Microsoft Windows XP und höheren Betriebssystemen. |
| Zielplattform | Desktop |
| Kopfzeile | bdasup.h (include Bdasup.h) |
| Bibliothek | Bdasup.lib |
| IRQL | PASSIVE_LEVEL |