BdaPropertyNodeDescriptors - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
// bdasup.h

NTSTATUS BdaPropertyNodeDescriptors(
  [in]            PIRP               pIrp,
  [in]            PKSPROPERTY        pKSProperty,
  [out, optional] BDANODE_DESCRIPTOR *pNodeDescriptorProperty
);
View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Windows Driver Kit DDI reference (nf-bdasup-bdapropertynodedescriptors)

Description

The BdaPropertyNodeDescriptors function retrieves a list of nodes in a template topology.

Parameters

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.

Return value

Returns STATUS_SUCCESS or an appropriate error code.

Remarks

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.

See also

KSPROPERTY

KSPROPERTY_BDA_NODE_DESCRIPTORS

KSPROPSETID_BdaTopology