다음을 통해 공유


고정 속성 집합

[DirectShow 이 페이지와 연결된 기능은 레거시 기능입니다. MediaPlayer, IMFMediaEngine, Media Foundation 오디오/비디오 캡처대체되었습니다. 이러한 기능은 Windows 10 및 Windows 11에 최적화되었습니다. Microsoft는 가능하면 새로운 코드에서 MediaPlayer, IMFMediaEngineAudio/Video Capture를 DirectShow대신 Media Foundation 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]

pin 속성 집합은 필터의 핀에 대한 핀 범주를 반환합니다. 범주는 핀을 만들 때 필터에 의해 설정됩니다. 범주는 핀이 이 핀에 의해 전달되거나 수신되는 데이터 형식을 나타냅니다.

레이블
속성 집합 GUID AMPROPSETID_Pin

 

속성 ID 묘사
AMPROPERTY_PIN_CATEGORY 핀의 범주를 지정합니다.

 

DirectShow는 Uuids.h 헤더 파일에서 다음 핀 범주를 정의합니다.

범주 GUID 묘사
PIN_CATEGORY_ANALOGVIDEOIN 아날로그를 사용하고 디지털화하는 캡처 필터의 입력 핀입니다.
PIN_CATEGORY_CAPTURE 캡처 핀.
PIN_CATEGORY_CC 줄 21에서 선택 자막 데이터를 제공하는 고정입니다.
PIN_CATEGORY_EDS 확장 데이터 서비스를 제공하는 핀(줄 21, 짝수 필드).
PIN_CATEGORY_NABTS 북미 Videotext Standard 데이터를 제공하는 핀입니다.
PIN_CATEGORY_PREVIEW 미리 보기 핀.
PIN_CATEGORY_STILL 스틸 이미지를 제공하는 핀입니다. 스틸 이미지 핀이 연결되기 전에 필터의 캡처 핀을 연결해야 합니다.
PIN_CATEGORY_TELETEXT 원격 텍스트(선택 캡션 변형)를 제공하는 핀입니다.
PIN_CATEGORY_TIMECODE 제공된 시간 코드 데이터를 고정합니다.
PIN_CATEGORY_VBI 수직 공백 간격 데이터를 제공하는 고정입니다.
PIN_CATEGORY_VIDEOPORT 오버레이 믹서입력 핀 0에 연결할 비디오 출력 핀입니다.
PIN_CATEGORY_VIDEOPORT_VBI VBI Surface 할당자 연결되도록 고정합니다. 비디오 포트가 사용되는 시나리오에서 선택 자막 오버레이와 같은 항목에 대해 올바른 비디오 메모리를 할당하는 데 필요한 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 함수를 사용하여 인터페이스 포인터를 해제합니다.

 

캡처 필터 대한 고정 요구 사항

속성 집합

범주 고정 작업