IUnregisterPhysicalConnection::UnregisterPhysicalConnectionFromExternal method (portcls.h)

Article
10/21/2021
2 minutes to read

The UnregisterPhysicalConnectionFromExternal method deletes the registration of a physical connection that was registered by a previous call to PcRegisterPhysicalConnectionFromExternal.

Syntax

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

Parameters

[in] DeviceObject

Pointer to the device object for the adapter device. This parameter must point to a system structure of type DEVICE_OBJECT.

[in] FromString

Pointer to a null-terminated Unicode string that contains the name of the external filter that supplies the connection's data source pin.

[in] FromPin

Specifies a pin ID. This parameter identifies the data source (output) pin on the external filter that is named by the FromString parameter.

[in] ToUnknown

Pointer to the IPort interface of a port driver object. The port driver object that is associated with ToUnknown is bound to the subdevice that supplies the connection's data sink pin.

[in] ToPin

Specifies a pin ID. This parameter identifies the data sink (input) pin on the filter that is associated with the ToUnknown interface.

Return value

UnregisterPhysicalConnectionFromExternal returns STATUS_SUCCESS if the call was successful. Otherwise, it returns an appropriate error code.

Remarks

For more information, see Dynamic Audio Subdevices.

Requirements


Target Platform	Universal
Header	portcls.h (include Portcls.h)
IRQL	PASSIVE_LEVEL