BdaPropertyNodeEvents function (bdasup.h)

The BdaPropertyNodeEvents function retrieves a list of events that a node supports.

Syntax

NTSTATUS BdaPropertyNodeEvents(
  [in]            PIRP      pIrp,
  [in]            PKSP_NODE pKSProperty,
  [out, optional] GUID      *pguidProperty
);

Parameters

[in] pIrp

Points to the IRP for the request to retrieve the list of events for a node. The BDA minidriver receives this IRP with the KSPROPERTY_BDA_NODE_EVENTS request.

[in] pKSProperty

Points to a KSPROPERTY structure that describes the property and request type of the property request.

[out, optional] pguidProperty

Points to an array that receives the list of GUIDs for the events supported by a node.

Return value

Returns STATUS_SUCCESS or an appropriate error code.

Remarks

A BDA minidriver calls the BdaPropertyNodeEvents function to retrieve the list of events for a node after the minidriver receives a KSPROPERTY_BDA_NODE_EVENTS request of the KSPROPSETID_BdaTopology property set from the network provider. Most BDA minidrivers can define dispatch and filter-automation tables so that those minidrivers dispatch the BdaPropertyNodeEvents function directly, without intercepting this request using an internal get-handler (KStrGetPropertyHandler). See Defining Automation Tables and Determining BDA Device Topology for more information.

Requirements

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

See also

KSPROPERTY

KSPROPERTY_BDA_NODE_EVENTS

KSPROPSETID_BdaTopology