Expand Minimize

KsPinGetConnectedPinDeviceObject function

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


PDEVICE_OBJECT KsPinGetConnectedPinDeviceObject(
  _In_  PKSPIN Pin
);

Parameters

Pin [in]

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

Target platform

Universal

Version

Available in Microsoft Windows XP and later operating systems and DirectX 8.0 and later DirectX versions.

Header

Ks.h (include Ks.h)

Library

Ks.lib

See also

KsGetDeviceForDeviceObject

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft