BdaCheckChanges function (bdasup.h)

The BdaCheckChanges function verifies a new set of BDA topology changes before they are committed.

Syntax

NTSTATUS BdaCheckChanges(
  [in] PIRP pIrp
);

Parameters

[in] pIrp

Points to the IRP for the request to verify changes. The BDA minidriver receives this IRP with the KSMETHOD_BDA_CHECK_CHANGES request.

Return value

Returns STATUS_SUCCESS or an appropriate error code. Returns the result that the BdaCommitChanges function would have returned.

Remarks

A BDA minidriver calls the BdaCheckChanges function to verify a group of BDA topology changes after the minidriver receives a KSMETHOD_BDA_CHECK_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 BdaCheckChanges function directly or intercept this request using an internal method (KStrMethodHandler), which then calls the BdaCheckChanges 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 validate the new list of resources for the filter. See Defining Automation Tables and Changing BDA Filter Properties for more information.

Requirements

Requirement Value
Target Platform Desktop
Header bdasup.h (include Bdasup.h)
Library Bdasup.lib
IRQL PASSIVE_LEVEL

See also

BdaCommitChanges

KSMETHODSETID_BdaChangeSync

KSMETHOD_BDA_CHECK_CHANGES

KStrMethodHandler