BdaCommitChanges-Funktion (bdasup.h)

Die BdaCommitChanges--Funktion setzt die Änderungen an der BDA-Topologie fest, die seit dem letzten Aufruf der BdaStartChanges--Funktion aufgetreten sind.

Syntax

NTSTATUS BdaCommitChanges(
  [in] PIRP pIrp
);

Parameter

[in] pIrp

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

Rückgabewert

Gibt STATUS_SUCCESS oder einen entsprechenden Fehlercode zurück.

Bemerkungen

Ein BDA-Minidriver ruft die BdaCommitChanges-Funktion auf, um eine Reihe von BDA-Topologieänderungen zu übernehmen, nachdem der Minidriver eine KSMETHOD_BDA_COMMIT_CHANGES Anforderung der vom Netzwerkanbieter festgelegten KSMETHODSETID_BdaChangeSync-Methode empfängt. BDA-Minidriver definieren Verteiler- und Filterautomatisierungstabellen, sodass diese Minidriver entweder die BdaCommitChanges Funktion direkt verteilen oder diese Anforderung mithilfe einer internen Methode (KStrMethodHandler) abfangen, die dann die BdaCommitChanges-Funktion aufruft. Beispielsweise können BDA-Minidriver, die diese Anforderung abfangen, einen Zeiger auf den BDA-Filter aus dem übergebenen IRP abrufen, damit 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.

• Übernehmen Sie die Ressourcen auf dem zugrunde liegenden Gerät.

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

Anforderungen

Siehe auch

BDA_CHANGE_STATE

BdaCheckChanges-

BdaStartChanges-

KSMETHODSETID_BdaChangeSync

KSMETHOD_BDA_COMMIT_CHANGES

KStrMethodHandler-