BdaPropertyGetPinControl-Funktion (bdasup.h)

Artikel
02/22/2024

Die BdaPropertyGetPinControl-Funktion ruft entweder den Bezeichner oder den Typ einer Pin ab.

Syntax

NTSTATUS BdaPropertyGetPinControl(
  [in]            PIRP        Irp,
  [in]            PKSPROPERTY Property,
  [out, optional] ULONG       *pulProperty
);

Parameter

[in] Irp

Verweist auf den IRP für die Anforderung zum Abrufen von Pininformationen. Der BDA-Minidriver empfängt diese IRP entweder mit der KSPROPERTY_BDA_PIN_ID - oder KSPROPERTY_BDA_PIN_TYPE-Anforderung .

[in] Property

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

[out, optional] pulProperty

Verweist auf eine Variable, die entweder den Bezeichner oder den Typ einer Pin empfängt.

Rückgabewert

Gibt STATUS_SUCCESS oder einen entsprechenden Fehlercode zurück.

Hinweise

Ein BDA-Minidriver ruft die BdaPropertyGetPinControl-Funktion auf, um entweder den Bezeichner oder den Typ einer Pin abzurufen, nachdem der Minitreiber entweder eine KSPROPERTY_BDA_PIN_ID - oder KSPROPERTY_BDA_PIN_TYPE Anforderung des KSPROPSETID_BdaPinControl-Eigenschaftssatzes empfangen hat. Die meisten BDA-Minitreiber können Pinautomatisierungstabellen definieren, sodass diese Minidriver die BdaPropertyGetPinControl-Funktion direkt senden, ohne diese Anforderung mithilfe eines internen Get-Handlers (KStrGetPropertyHandler) abzufangen.