Поделиться через


структура PIN_INFO (strmif.h)

[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать в новом коде MediaPlayer, IMFMediaEngine и аудио/видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие API, чтобы по возможности использовать новые API.]

Структура PIN_INFO содержит сведения о контакте.

Синтаксис

typedef struct _PinInfo {
  IBaseFilter   *pFilter;
  PIN_DIRECTION dir;
  WCHAR         achName[128];
} PIN_INFO;

Члены

pFilter

Указатель на интерфейс IBaseFilter фильтра-владения.

dir

Направление закрепления (входные или выходные данные).

achName[128]

Имя контакта.

Комментарии

Если имя выходного контакта начинается с тильды (~), диспетчер графов фильтров игнорирует контакт при построении графа. При вызове IGraphBuilder::Connect, IGraphBuilder::Render или IGraphBuilder::RenderFile, если закрепление отображается на промежуточном фильтре, диспетчер графов фильтров не отображает закрепление. Однако он отрисовывает закрепление, если он явно передается методу Connect или Render .

Используйте тильду, если контакт доставляет дополнительный поток, который не должен быть отрисован по умолчанию, или если для правильной отрисовки пин-кода требуется специальный код. Например, фильтры DVD-дисков должны использовать его для контактов, которые предоставляют вложенные или скрытые субтитры. Фильтры захвата видео должны использовать его для контактов захвата (но не для предварительного просмотра).

Элемент pFilter имеет незавершенное число ссылок. Приложение должно освободить интерфейс .

Требования

   
Верхняя часть strmif.h (включая Dshow.h)

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

Структуры DirectShow

IPin::QueryPinInfo