고정 속성 집합
[DirectShow 이 페이지와 연결된 기능은 레거시 기능입니다. MediaPlayer, IMFMediaEngine, Media Foundation 오디오/비디오 캡처대체되었습니다. 이러한 기능은 Windows 10 및 Windows 11에 최적화되었습니다. Microsoft는 가능하면 새로운 코드에서 MediaPlayer, IMFMediaEngine 및 Audio/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 함수를 사용하여 인터페이스 포인터를 해제합니다.
관련 항목