BdaPropertyGetControllingPinId-Funktion (bdasup.h)

Artikel
02/22/2024

Die BdaPropertyGetControllingPinId-Funktion ruft den Bezeichner einer Pin ab, an der die Eigenschaften, Methoden und Ereignisse eines bestimmten Knotens gesteuert werden sollen.

Syntax

NTSTATUS BdaPropertyGetControllingPinId(
  [in]            PIRP              Irp,
  [in]            PKSP_BDA_NODE_PIN Property,
  [out, optional] PULONG            pulControllingPinId
);

Parameter

[in] Irp

Verweist auf den IRP für die Anforderung, den steuernden Pin für einen Knoten abzurufen. Der BDA-Minidriver empfängt diese IRP mit der KSPROPERTY_BDA_CONTROLLING_PIN_ID Anforderung.

[in] Property

Verweist auf eine KSP_BDA_NODE_PIN Struktur, die die Eigenschaft und den Anforderungstyp der Eigenschaftenanforderung beschreibt, um den steuernden Pin für einen Knoten abzurufen.

[out, optional] pulControllingPinId

Verweist auf eine Variable, die den Bezeichner des Steuerstifts für einen Knoten empfängt.

Rückgabewert

Gibt STATUS_SUCCESS oder einen entsprechenden Fehlercode zurück.

Hinweise

Ein BDA-Minidriver ruft die BdaPropertyGetControllingPinId-Funktion auf, um den Bezeichner der Steuernadel für einen Knoten abzurufen, nachdem der Minitreiber eine KSPROPERTY_BDA_CONTROLLING_PIN_ID Anforderung des KSPROPSETID_BdaTopology Eigenschaftensatzes vom Netzwerkanbieter erhalten hat. Die meisten BDA-Minidriver können Dispatch- und Filterautomatisierungstabellen definieren, sodass diese Minitreiber die BdaPropertyGetControllingPinId-Funktion direkt senden, ohne diese Anforderung mithilfe eines internen Get-Handlers (KStrGetPropertyHandler) abzufangen. Weitere Informationen finden Sie unter Definieren von Automatisierungstabellen und Ermitteln der BDA-Gerätetopologie .