BdaMethodDeletePin-Funktion (bdasup.h)

Artikel
02/06/2025

Die BdaMethodDeletePin Funktion löscht eine Pinfactory.

Syntax

NTSTATUS BdaMethodDeletePin(
  [in] PIRP      pIrp,
  [in] PKSMETHOD pKSMethod,
       PVOID     pvIgnored
);

Parameter

[in] pIrp

Verweist auf das IRP für die Anforderung zum Löschen einer Pin-Factory. Der BDA-Minidriver empfängt diese IRP mit der KSMETHOD_BDA_DELETE_PIN_FACTORY Anforderung.

[in] pKSMethod

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

pvIgnored

Verweist auf einen Puffer, der ignoriert wird.

Rückgabewert

Gibt STATUS_SUCCESS oder einen entsprechenden Fehlercode zurück.

Bemerkungen

Ein BDA-Minidriver ruft die BdaMethodDeletePin--Funktion auf, um eine Pin-Factory zu löschen, nachdem der Minidriver eine KSMETHOD_BDA_DELETE_PIN_FACTORY Anforderung der vom Netzwerkanbieter festgelegten KSMETHODSETID_BdaDeviceConfiguration-Methode empfängt. Die meisten BDA-Minidriver können Verteiler- und Filterautomatisierungs-Tabellen definieren, sodass diese Minidriver die BdaMethodDeletePin 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 löschen muss, ohne sich auf den Netzwerkanbieter zu verlassen, sollte der BDA-Minidriver die BdaDeletePin-Funktion aufrufen.