BdaValidateNodeProperty function (bdasup.h)

Article
04/26/2022

The BdaValidateNodeProperty function validates that a node property request is associated with a specific pin.

Syntax

NTSTATUS BdaValidateNodeProperty(
  [in] PIRP        pIrp,
  [in] PKSPROPERTY pProperty
);

Parameters

[in] pIrp

Points to the IRP for the request to validate that the current pin controls the node property at pProperty. The BDA minidriver can receive this IRP with the KSPROPERTY_BDA_RF_TUNER_FREQUENCY or KSPROPERTY_BDA_AUTODEMODULATE_START request.

[in] pProperty

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

Return value

Returns STATUS_SUCCESS or an appropriate error code.

Remarks

A pin method in a BDA minidriver calls the BdaValidateNodeProperty function to validate that the pin controls a specific node property after the minidriver receives the node property request from the network provider. This node property request can be, for example, a KSPROPERTY_BDA_RF_TUNER_FREQUENCY request of the KSPROPSETID_BdaFrequencyFilter property set or a KSPROPERTY_BDA_AUTODEMODULATE_START request of the KSPROPSETID_BdaAutodemodulate property set. These property sets manipulate tuner and demodulator nodes. After successfully calling BdaValidateNodeProperty, the minidriver obtains a pointer to the BDA filter from the passed IRP so that the minidriver can perform an operation on the particular node.

Requirements

Requirement	Value
Minimum supported client	Available on Microsoft Windows XP and later operating systems. This routine is available on the Windows 2000 platform only if Microsoft DirectX 9.0 and later is installed on that platform.
Target Platform	Desktop
Header	bdasup.h (include Bdasup.h)
Library	Bdasup.lib
IRQL	PASSIVE_LEVEL