BdaMethodCreatePin-Funktion (bdasup.h)

Artikel
02/26/2024

Die BdaMethodCreatePin-Funktion erstellt eine Pinfactory.

Syntax

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

Parameter

[in] pIrp

Verweist auf den IRP für die Anforderung, eine Pinfactory zu erstellen. Der BDA-Minidriver empfängt diese 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 Pinfactory empfängt.

Rückgabewert

Gibt STATUS_SUCCESS oder einen entsprechenden Fehlercode zurück.

Hinweise

Ein BDA-Minidriver ruft die BdaMethodCreatePin-Funktion auf, um eine Pinfactory zu erstellen, nachdem der Minitreiber eine KSMETHOD_BDA_CREATE_PIN_FACTORY Anforderung der KSMETHODSETID_BdaDeviceConfiguration-Methode vom Netzwerkanbieter erhalten hat. Die meisten BDA-Minidriver können Dispatch- und Filterautomatisierungstabellen definieren, sodass diese Minidriver die BdaMethodCreatePin-Funktion direkt senden, ohne diese Anforderung mithilfe einer internen Methode (KStrMethodHandler) abzufangen. Weitere Informationen finden Sie unter Definieren von Automatisierungstabellen und Konfigurieren eines BDA-Filters .

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