Compartir a través de

Pin (conjunto de propiedades)

  • Artículo

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El conjunto de propiedades pin devuelve la categoría de patillas de un pin en un filtro. El filtro establece la categoría cuando crea el pin; la categoría indica qué tipo de datos entrega o recibe el pin.

Etiqueta Value
GUID del conjunto de propiedades AMPROPSETID_Pin

 

Id. de propiedad Descripción
AMPROPERTY_PIN_CATEGORY Especifica la categoría de un pin.

 

DirectShow define las siguientes categorías de patillas en el archivo de encabezado Uuids.h.

GUID de categoría Descripción
PIN_CATEGORY_ANALOGVIDEOIN Pin de entrada del filtro de captura que toma analógico y lo digitaliza.
PIN_CATEGORY_CAPTURE Pin de captura.
PIN_CATEGORY_CC Anclar proporcionando datos de subtítulos de la línea 21.
PIN_CATEGORY_EDS Anclar que proporciona Servicios de datos extendidos (línea 21, campos pares).
PIN_CATEGORY_NABTS Anclar que proporciona datos estándar de Videotext de Norteamérica.
PIN_CATEGORY_PREVIEW Anclar de vista previa.
PIN_CATEGORY_STILL Anclar que proporciona una imagen fija. El pin de captura del filtro debe estar conectado antes de que se conecte el pin de imagen fija.
PIN_CATEGORY_TELETEXT Anclar que proporciona teletexto (una variante de subtítulos).
PIN_CATEGORY_TIMECODE Anclar proporcionando datos de código de tiempo.
PIN_CATEGORY_VBI Anclar proporcionando datos de intervalo en blanco vertical.
PIN_CATEGORY_VIDEOPORT Pin de salida de vídeo que se va a conectar al pin de entrada cero en el mezclador de superposición.
PIN_CATEGORY_VIDEOPORT_VBI Anclar para conectarse al asignador de superficie de VBI, el filtro de asignador de superficie VBI necesario para asignar la memoria de vídeo correcta para elementos como superposiciones de subtítulos en escenarios en los que se usa un puerto de vídeo. Los escenarios PCI, IEEE 1394 y USB no usan este filtro.
PINNAME_VIDEO_CC_CAPTURE Anclaje de subtítulos de segmentación de hardware

 

Esta propiedad es de solo lectura.

Código de ejemplo

En el código siguiente se muestra cómo comprobar si un pin admite este conjunto de propiedades y, si es así, cómo obtener la categoría de anclaje:

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;
}

Nota:

En este ejemplo se usa la función SafeRelease para liberar punteros de interfaz.

 

Requisitos de anclaje para filtros de captura

Conjuntos de propiedades

Trabajar con categorías de patillas