// bdasup.h
NTSTATUS BdaPropertyNodeDescriptors(
[in] PIRP pIrp,
[in] PKSPROPERTY pKSProperty,
[out, optional] BDANODE_DESCRIPTOR *pNodeDescriptorProperty
);
View the official Windows Driver Kit DDI referenceNo description available.
The BdaPropertyNodeDescriptors function retrieves a list of nodes in a template topology.
pIrp [in]Points to the IRP for the request to retrieve the list of nodes. The BDA minidriver receives this IRP with the KSPROPERTY_BDA_NODE_DESCRIPTORS request.
pKSProperty [in]Points to a KSPROPERTY structure that describes the property and request type of the property request.
pNodeDescriptorProperty [out, optional]Points to an array that receives the list of GUIDs for the nodes in a template topology.
Returns STATUS_SUCCESS or an appropriate error code.
A BDA minidriver calls the BdaPropertyNodeDescriptors function to retrieve the list of nodes after the minidriver receives a KSPROPERTY_BDA_NODE_DESCRIPTORS 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 BdaPropertyNodeDescriptors function directly, without intercepting this request using an internal get-handler (KStrGetPropertyHandler). See Defining Automation Tables and Determining BDA Device Topology for more information.
For a list of BDA nodes that are available to create in a template topology, see BDA Node Category GUIDs.
KSPROPERTY_BDA_NODE_DESCRIPTORS