BdaPropertyNodeEvents-Funktion (bdasup.h)

Artikel
02/26/2024

Die BdaPropertyNodeEvents-Funktion ruft eine Liste der Ereignisse ab, die von einem Knoten unterstützt werden.

Syntax

NTSTATUS BdaPropertyNodeEvents(
  [in]            PIRP      pIrp,
  [in]            PKSP_NODE pKSProperty,
  [out, optional] GUID      *pguidProperty
);

Parameter

[in] pIrp

Verweist auf den IRP für die Anforderung zum Abrufen der Ereignisliste für einen Knoten. Der BDA-Minidriver empfängt diese IRP mit der KSPROPERTY_BDA_NODE_EVENTS Anforderung.

[in] pKSProperty

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

[out, optional] pguidProperty

Verweist auf ein Array, das die Liste der GUIDs für die von einem Knoten unterstützten Ereignisse empfängt.

Rückgabewert

Gibt STATUS_SUCCESS oder einen entsprechenden Fehlercode zurück.

Hinweise

Ein BDA-Minidriver ruft die BdaPropertyNodeEvents-Funktion auf, um die Liste der Ereignisse für einen Knoten abzurufen, nachdem der Minitreiber eine KSPROPERTY_BDA_NODE_EVENTS Anforderung des KSPROPSETID_BdaTopology Eigenschaftssatzes vom Netzwerkanbieter empfangen hat. Die meisten BDA-Minidriver können Dispatch- und Filterautomatisierungstabellen definieren, sodass diese Minidriver die BdaPropertyNodeEvents-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 .