Edit

KsPinGetConnectedPinDeviceObject function (ks.h)

  • Article

The KsPinGetConnectedPinDeviceObject function returns the device object at the top of the device stack corresponding to the sink pin attached to the source pin Pin.

Syntax

KSDDKAPI PDEVICE_OBJECT KsPinGetConnectedPinDeviceObject(
  [in] PKSPIN Pin
);

Parameters

[in] Pin

A pointer to a KSPIN structure that is the source pin for which to obtain the connected sink pin's device object.

Return value

If Pin is a source pin, KsPinGetConnectedPinDeviceObject returns a pointer to the DEVICE_OBJECT structure at the top of the device stack on which the sink pin resides. Otherwise, it returns NULL.

Remarks

The returned device object is not necessarily the functional device object (FDO) for the device on which the sink resides, since there might exist an upper level filter driver. It is, however, the device object to which IOCTLs destined for the sink pin are sent.

Requirements

Requirement Value
Minimum supported client Available in Microsoft Windows XP and later operating systems and DirectX 8.0 and later DirectX versions.
Target Platform Universal
Header ks.h (include Ks.h)
Library Ks.lib

See also

KsGetDeviceForDeviceObject