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 |