| Microsoft DirectX 8.1 (C++) |
The pin property set enables you to retrieve the category to which a pin belongs, if any. The category is set by the filter when it creates the pin; the category indicates what type of data the pin is streaming. The most commonly used categories are for the capture and preview pins on a capture filter. The AMCap sample in the [SDK Root]/samples/multimedia/DirectShow/Capture/AMCap directory illustrates how to use this property set when building filter graphs based on video capture devices that conform to the Windows Driver Model (WDM).
The following information presents the necessary constants and data types to use for this property set in calls to IKsPropertySet methods. It provides values for the GUID (guidPropSet), property ID (dwPropID), and property data type (pPropData) parameters.
Property Set GUID: AMPROPSETID_Pin
The AMPROPERTY_PIN_CATEGORY pin category property is the only property in this property set. This property uses a GUID data type. Microsoft® DirectShow® defines the following pin categories in Uuids.h, which you can find in the SDK Include directory.
| Category | Description |
| PIN_CATEGORY_ANALOGVIDEOIN | Input pin of the capture filter that takes analog and digitizes it. |
| PIN_CATEGORY_CAPTURE | Capture pin. |
| PIN_CATEGORY_CC | Pin providing closed captioning data from Line 21. |
| PIN_CATEGORY_EDS | Pin providing Extended Data Services (Line 21, even fields). |
| PIN_CATEGORY_NABTS | Pin providing North American Videotext Standard data. |
| PIN_CATEGORY_PREVIEW | Preview pin. |
| PIN_CATEGORY_STILL | Pin that provides a still image. The filter's capture pin must be connected before the still-image pin is connected. |
| PIN_CATEGORY_TELETEXT | Pin providing teletext (a closed captioning variant). |
| PIN_CATEGORY_TIMECODE | Pin providing timecode data. |
| PIN_CATEGORY_VBI | Pin providing vertical blanking interval data. |
| PIN_CATEGORY_VIDEOPORT | Video output pin to be connected to input pin zero on the Overlay Mixer. |
| PIN_CATEGORY_VIDEOPORT_VBI | Pin to be connected to the VBI Surface Allocator, the VBI surface allocator filter that is needed to allocate the correct video memory for things like closed captioning overlays in scenarios where a video port is being used. PCI, IEEE 1394, and USB scenarios do not use this filter. For more information, see Microsoft TV Technologies. |
Use the IKsPropertySet interface to set, retrieve, and query for support of these properties.