BdaMethodCreatePin-Funktion (bdasup.h)

Die BdaMethodCreatePin-Funktion erstellt eine Pin-Factory.

Syntax

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

Parameter

[in] pIrp

Verweist auf das IRP für die Anforderung, um eine Pin-Factory 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 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 Funktion BdaMethodCreatePin direkt verteilen, 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-Minidriver die BdaCreatePin-Funktion aufrufen.

Anforderungen

   
Zielplattform Desktop
Header bdasup.h (include Bdasup.h)
Bibliothek Bdasup.lib
IRQL PASSIVE_LEVEL

Siehe auch

BdaCreatePin

BdaMethodDeletePin

KSMETHOD

KSMETHODSETID_BdaDeviceConfiguration

KSMETHOD_BDA_CREATE_PIN_FACTORY

KStrMethodHandler