BdaMethodDeletePin-Funktion (bdasup.h)

Artikel
02/22/2024

Die BdaMethodDeletePin-Funktion löscht eine Pinfactory.

Syntax

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

Parameter

[in] pIrp

Verweist auf den IRP für die Anforderung zum Löschen einer Pinfactory. 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.

Hinweise

Ein BDA-Minidriver ruft die BdaMethodDeletePin-Funktion auf, um eine Pinfactory zu löschen, nachdem der Minitreiber eine KSMETHOD_BDA_DELETE_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 BdaMethodDeletePin-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 löschen muss, ohne sich auf den Netzwerkanbieter zu verlassen, sollte der BDA-Minidriver die BdaDeletePin-Funktion aufrufen.