BdaMethodCreatePin-Funktion (bdasup.h)

Artikel
02/06/2025

Die BdaMethodCreatePin--Funktion erstellt eine Pinfactory.

Syntax

NTSTATUS BdaMethodCreatePin(
  [in]            PIRP      pIrp,
  [in]            PKSMETHOD pKSMethod,
  [out, optional] PULONG    pulPinFactoryID
);

Parameter

[in] pIrp

Verweist auf das IRP für die Anforderung zum Erstellen einer Pin-Factory. Der BDA-Minidriver empfängt dieses IRP mit der KSMETHOD_BDA_CREATE_PIN_FACTORY Anforderung.

[in] pKSMethod

Verweist auf eine KSMETHOD- Struktur, die die Methode und den Anforderungstyp einer Methodenanforderung beschreibt.

[out, optional] pulPinFactoryID

Verweist auf eine Variable, die den Bezeichner der Pin-Factory empfängt.

Rückgabewert

Gibt STATUS_SUCCESS oder einen entsprechenden Fehlercode zurück.

Bemerkungen

Ein BDA-Minidriver ruft die BdaMethodCreatePin--Funktion auf, um eine Pin-Factory zu erstellen, nachdem der Minidriver eine KSMETHOD_BDA_CREATE_PIN_FACTORY Anforderung der vom Netzwerkanbieter festgelegten KSMETHODSETID_BdaDeviceConfiguration-Methode empfängt. Die meisten BDA-Minidriver können Verteiler- und Filterautomatisierungstabellen definieren, sodass diese Minidriver die BdaMethodCreatePin Funktion direkt verteilen, ohne diese Anforderung mithilfe einer internen Methode abzufangen (KStrMethodHandler). Weitere Informationen finden Sie unter Definieren von Automatisierungstabellen und Konfigurieren eines BDA-Filter-.

Wenn ein BDA-Minidriver einen Pin erstellen muss, ohne sich auf den Netzwerkanbieter zu verlassen, sollte der BDA-Minidriver die BdaCreatePin-Funktion aufrufen.