Функция KsPinGetConnectedPinDeviceObject (ks.h)

Функция KsPinGetConnectedPinDeviceObject возвращает объект устройства в верхней части стека устройств, соответствующий контакту приемника, подключенному к контакту источника.

Синтаксис

KSDDKAPI PDEVICE_OBJECT KsPinGetConnectedPinDeviceObject(
  [in] PKSPIN Pin
);

Параметры

[in] Pin

Указатель на структуру KSPIN , которая является исходным контактом, для которого требуется получить объект устройства контакта подключенного приемника.

Возвращаемое значение

Если pin является исходным, KsPinGetConnectedPinDeviceObject возвращает указатель на структуру DEVICE_OBJECT в верхней части стека устройств, в котором находится контакт приемника. В противном случае возвращается значение NULL.

Комментарии

Возвращаемый объект устройства не обязательно является объектом функционального устройства (FDO) для устройства, на котором находится приемник, так как может существовать драйвер фильтра верхнего уровня. Однако это объект устройства, в который отправляются ioCTL, предназначенные для контакта приемника.

Требования

Требование Значение
Минимальная версия клиента Доступно в операционных системах Microsoft Windows XP и более поздних версиях, а также DirectX 8.0 и более поздних версий.
Целевая платформа Универсальное
Верхняя часть ks.h (включая Ks.h)
Библиотека Ks.lib

См. также раздел

KsGetDeviceForDeviceObject