KsPinGetConnectedPinDeviceObject function (ks.h)
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 |