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

Набор свойств Pin

  • Статья

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

Набор свойств пин-кода возвращает категорию пин-кода для закреплений фильтра. Категория устанавливается фильтром при создании пин-кода; Категория указывает, какой тип данных доставляется или получает этот пин-код.

Ярлык Ценность
GUID набора свойств AMPROPSETID_Pin

 

Идентификатор свойства Описание
AMPROPERTY_PIN_CATEGORY Указывает категорию пин-кода.

 

DirectShow определяет следующие категории контактов в файле заголовка Uuids.h.

GUID категории Описание
PIN_CATEGORY_ANALOGVIDEOIN Входной пин-код фильтра записи, который принимает аналоговый и оцифровывает его.
PIN_CATEGORY_CAPTURE Зафиксировать закрепление.
PIN_CATEGORY_CC Закрепление, предоставляющее данные с закрытыми заголовками из строки 21.
PIN_CATEGORY_EDS Закрепление расширенных служб данных (строка 21, даже поля).
PIN_CATEGORY_NABTS Закрепление, предоставляющее данные "Стандартный" для северо-американского видеотекста.
PIN_CATEGORY_PREVIEW Предварительный просмотр пин-кода.
PIN_CATEGORY_STILL Закрепление, предоставляющее по-прежнему изображение. Перед подключением пин-кода захвата фильтра необходимо подключить к закреплению по-прежнему изображения.
PIN_CATEGORY_TELETEXT Закрепление, предоставляющее телетекст (вариант закрытого заголовка).
PIN_CATEGORY_TIMECODE Закрепление, предоставляющее данные кода времени.
PIN_CATEGORY_VBI Закрепление, предоставляющее данные интервала вертикального пустого интервала.
PIN_CATEGORY_VIDEOPORT Пин-код вывода видео, который должен быть подключен к входному закреплению ноль на Overlay Mixer.
PIN_CATEGORY_VIDEOPORT_VBI Закрепление для подключения к VBI Surface Allocator, фильтр распределителя поверхности VBI, который необходим для выделения правильной памяти видео для таких вещей, как закрытые наложения в сценариях, где используется видеопорт. Сценарии PCI, IEEE 1394 и USB не используют этот фильтр.
PINNAME_VIDEO_CC_CAPTURE Закрепление закрытого заголовка для срезов оборудования

 

Это свойство доступно только для чтения.

Пример кода

В следующем коде показано, как проверить, поддерживает ли пин-код этот набор свойств, и если да, как получить категорию пин-кода:

HRESULT GetPinCategory(IPin *pPin, GUID *pPinCategory)
{
    IKsPropertySet *pKs = NULL;

    HRESULT hr = pPin->QueryInterface(IID_PPV_ARGS(&pKs));
    if (FAILED(hr))
    {
        return hr;
    }

    // Try to retrieve the pin category.
    DWORD cbReturned = 0;
    hr = pKs->Get(AMPROPSETID_Pin, AMPROPERTY_PIN_CATEGORY, NULL, 0, 
        pPinCategory, sizeof(GUID), &cbReturned);
    
    // If this succeeded, pPinCategory now contains the category GUID.

    SafeRelease(&pKs);
    return hr;
}

Заметка

В этом примере используется функция safeRelease для выпуска указателей интерфейса.

 

Требования к закреплению для фильтров записи

наборы свойств

работа с категориями закреплений