IUnregisterPhysicalConnection::UnregisterPhysicalConnectionFromExternal-Methode (portcls.h)

Artikel
02/26/2024

Die UnregisterPhysicalConnectionFromExternal-Methode löscht die Registrierung einer physischen Verbindung, die durch einen vorherigen Aufruf von PcRegisterPhysicalConnectionFromExternal registriert wurde.

Syntax

NTSTATUS UnregisterPhysicalConnectionFromExternal(
  [in] PDEVICE_OBJECT  DeviceObject,
  [in] PUNICODE_STRING FromString,
  [in] ULONG           FromPin,
  [in] PUNKNOWN        ToUnknown,
  [in] ULONG           ToPin
);

Parameter

[in] DeviceObject

Zeiger auf das Geräteobjekt für das Adaptergerät. Dieser Parameter muss auf eine Systemstruktur vom Typ DEVICE_OBJECT verweisen.

[in] FromString

Zeiger auf eine Unicode-Zeichenfolge mit Null-Termin, die den Namen des externen Filters enthält, der die Datenquellen-Pin der Verbindung bereitstellt.

[in] FromPin

Gibt eine Pin-ID an. Dieser Parameter identifiziert den Datenquellen-Pin (Ausgabe)-Pin für den externen Filter, der vom FromString-Parameter benannt wird.

[in] ToUnknown

Zeiger auf die IPort-Schnittstelle eines Porttreiberobjekts. Das Porttreiberobjekt, das ToUnknown zugeordnet ist, ist an das Untergerät gebunden, das den Datensenke-Pin der Verbindung bereitstellt.

[in] ToPin

Gibt eine Pin-ID an. Dieser Parameter identifiziert die Datensenke (Eingabe) auf dem Filter, der der ToUnknown-Schnittstelle zugeordnet ist.

Rückgabewert

UnregisterPhysicalConnectionFromExternal gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich war. Andernfalls wird ein geeigneter Fehlercode zurückgegeben.