BdaPropertyNodeTypes function (bdasup.h)

The BdaPropertyNodeTypes function retrieves a list of node types in a template topology.

Syntax

NTSTATUS BdaPropertyNodeTypes(
  [in]  PIRP        pIrp,
  [in]  PKSPROPERTY pKSProperty,
  [out] ULONG       *pulProperty
);

Parameters

[in] pIrp

Points to the IRP for the request to retrieve the list of node types. The BDA minidriver receives this IRP with the KSPROPERTY_BDA_NODE_TYPES request.

[in] pKSProperty

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

[out] pulProperty

Points to an array that receives the list of node types.

Return value

Returns STATUS_SUCCESS or an appropriate error code.

Remarks

A BDA minidriver calls the BdaPropertyNodeTypes function to retrieve the list of node types after the minidriver receives a KSPROPERTY_BDA_NODE_TYPES 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 BdaPropertyNodeTypes 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_TYPES

KSPROPSETID_BdaTopology