BdaPropertyNodeProperties function (bdasup.h)

Article
04/26/2022

The BdaPropertyNodeProperties function retrieves a list of properties that a node supports.

Syntax

NTSTATUS BdaPropertyNodeProperties(
  [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 properties for a node. The BDA minidriver receives this IRP with the KSPROPERTY_BDA_NODE_PROPERTIES 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 properties supported by a node.

Return value

Returns STATUS_SUCCESS or an appropriate error code.

Remarks

A BDA minidriver calls the BdaPropertyNodeProperties function to retrieve the list of properties for a node after the minidriver receives a KSPROPERTY_BDA_NODE_PROPERTIES 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 BdaPropertyNodeProperties 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