BdaPropertyPinTypes function (bdasup.h)

Article
02/22/2024

The BdaPropertyPinTypes function retrieves a list of pin types in a template topology.

Syntax

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

Parameters

[in] pIrp

Points to the IRP for the request to retrieve list of pin types. The BDA minidriver receives this IRP with the KSPROPERTY_BDA_PIN_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 pin types.

Return value

Returns STATUS_SUCCESS or an appropriate error code.

Remarks

A BDA minidriver calls the BdaPropertyPinTypes function to retrieve the list of pin types after the minidriver receives a KSPROPERTY_BDA_PIN_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 BdaPropertyPinTypes 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