BdaPropertyGetControllingPinId-Funktion (bdasup.h)
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 .
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | bdasup.h (include Bdasup.h) |
| Bibliothek | Bdasup.lib |
| IRQL | PASSIVE_LEVEL |