BdaValidateNodeProperty-Funktion (bdasup.h)

Artikel
02/26/2024

Die BdaValidateNodeProperty-Funktion überprüft, ob eine Knoteneigenschaftsanforderung einem bestimmten Pin zugeordnet ist.

Syntax

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

Parameter

[in] pIrp

Verweist auf den IRP für die Anforderung, um zu überprüfen, ob der aktuelle Pin die node-Eigenschaft bei pProperty steuert. Der BDA-Minidriver kann diese IRP mit der KSPROPERTY_BDA_RF_TUNER_FREQUENCY - oder KSPROPERTY_BDA_AUTODEMODULATE_START-Anforderung empfangen.

[in] pProperty

Verweist auf eine KSPROPERTY-Struktur , die die Eigenschaft und den Anforderungstyp der Eigenschaftenanforderung beschreibt.

Rückgabewert

Gibt STATUS_SUCCESS oder einen entsprechenden Fehlercode zurück.

Hinweise

Eine pin-Methode in einem BDA-Minidriver ruft die BdaValidateNodeProperty-Funktion auf, um zu überprüfen, ob der Pin eine bestimmte Knoteneigenschaft steuert, nachdem der Minitreiber die Knoteneigenschaftsanforderung vom Netzwerkanbieter empfangen hat. Bei dieser Knoteneigenschaftsanforderung kann es sich z. B. um eine KSPROPERTY_BDA_RF_TUNER_FREQUENCY-Anforderung des KSPROPSETID_BdaFrequencyFilter-Eigenschaftssatzes oder um eine KSPROPERTY_BDA_AUTODEMODULATE_START-Anforderung des KSPROPSETID_BdaAutodemodulate-Eigenschaftssatzes. Diese Eigenschaftensätze bearbeiten Tuner- und Demodulatorknoten. Nach dem erfolgreichen Aufruf von BdaValidateNodeProperty ruft der Minidriver einen Zeiger auf den BDA-Filter aus dem übergebenen IRP ab, damit der Minitreiber einen Vorgang auf dem jeweiligen Knoten ausführen kann.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar unter Microsoft Windows XP und höheren Betriebssystemen. Diese Routine ist auf der Windows 2000-Plattform nur verfügbar, wenn Microsoft DirectX 9.0 und höher auf dieser Plattform installiert ist.
Zielplattform	Desktop
Kopfzeile	bdasup.h (include Bdasup.h)
Bibliothek	Bdasup.lib
IRQL	PASSIVE_LEVEL