Condividi tramite

Set di proprietà Pin

  • Articolo

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEnginee Acquisizione audio/video in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente di usare un nuovo codice MediaPlayer, IMFMediaEngine e Acquisizione audio/video in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il set di proprietà pin restituisce la categoria di puntina per un pin su un filtro. La categoria viene impostata dal filtro quando crea il pin; la categoria indica il tipo di dati che il pin viene recapitato o ricevuto da questo pin.

Etichetta Valore
GUID set di proprietà AMPROPSETID_Pin

 

ID proprietà Descrizione
AMPROPERTY_PIN_CATEGORY Specifica la categoria di un pin.

 

DirectShow definisce le categorie di pin seguenti nel file di intestazione Uuids.h.

GUID categoria Descrizione
PIN_CATEGORY_ANALOGVIDEOIN Pin di input del filtro di acquisizione che accetta analogico e digitalizzato.
PIN_CATEGORY_CAPTURE Pin di acquisizione.
PIN_CATEGORY_CC Aggiunta che fornisce dati di didascalia chiusa dalla riga 21.
PIN_CATEGORY_EDS Aggiunta che fornisce Servizi dati estesi (riga 21, campi pari).
PIN_CATEGORY_NABTS Aggiunta che fornisce dati Videotext Standard nordamericani.
PIN_CATEGORY_PREVIEW Pin di anteprima.
PIN_CATEGORY_STILL Aggiungi che fornisce un'immagine ancora. Il pin di acquisizione del filtro deve essere connesso prima che il pin dell'immagine ancora sia connesso.
PIN_CATEGORY_TELETEXT Aggiunta che fornisce il teletext (variante di didascalia chiusa).
PIN_CATEGORY_TIMECODE Aggiungere dati timecode.
PIN_CATEGORY_VBI Aggiunta che fornisce dati di intervallo di spaziatura verticale.
PIN_CATEGORY_VIDEOPORT Pin di output video da connettere al pin di input zero nell'Mixer overlay.
PIN_CATEGORY_VIDEOPORT_VBI Aggiungi per essere connesso all'allocatore surface VBI VBI, il filtro dell'allocatore di superficie VBI necessario per allocare la memoria video corretta per elementi come sovrapposizioni di sottotitoli chiusi in scenari in cui viene usata una porta video. Gli scenari PCI, IEEE 1394 e USB non usano questo filtro.
PINNAME_VIDEO_CC_CAPTURE Pin di slicing dell'hardware con didascalia chiusa

 

Questa proprietà è di sola lettura.

Codice di esempio

Il codice seguente illustra come verificare se un pin supporta questo set di proprietà e, in tal caso, come ottenere la categoria di pin:

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

In questo esempio viene usata la funzione SafeRelease per rilasciare i puntatori all'interfaccia.

 

requisiti di aggiunta per i filtri di acquisizione

set di proprietà

Uso delle categorie di pin