BdaCommitChanges function (bdasup.h)
The BdaCommitChanges function commits the changes to BDA topology that have occurred since the last call to the BdaStartChanges function.
Syntax
NTSTATUS BdaCommitChanges(
[in] PIRP pIrp
);
Parameters
[in] pIrp
Points to the IRP for the request to commit changes. The BDA minidriver receives this IRP with the KSMETHOD_BDA_COMMIT_CHANGES request.
Return value
Returns STATUS_SUCCESS or an appropriate error code.
Remarks
A BDA minidriver calls the BdaCommitChanges function to commit a set of BDA topology changes after the minidriver receives a KSMETHOD_BDA_COMMIT_CHANGES request of the KSMETHODSETID_BdaChangeSync method set from the network provider. BDA minidrivers define dispatch and filter-automation tables so that those minidrivers either dispatch the BdaCommitChanges function directly or intercept this request using an internal method (KStrMethodHandler), which then calls the BdaCommitChanges function. For example, BDA minidrivers that intercept this request can obtain a pointer to the BDA filter from the passed IRP so that they can:
Set the new list of resources for the filter to the pending list of resources.
Set the change state of the filter to BDA_CHANGES_COMPLETE.
Commit the resources on the underlying device.
See Defining Automation Tables and Changing BDA Filter Properties for more information.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Available on Microsoft Windows XP and later operating systems. |
| Target Platform | Desktop |
| Header | bdasup.h (include Bdasup.h) |
| Library | Bdasup.lib |
| IRQL | PASSIVE_LEVEL |