Condividi tramite

Set di proprietà Pin

  • Articolo

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, FMMediaEngine e Audio/Video Capture 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 pin per un pin in 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 Aggiungere i dati di didascalia chiusa dalla riga 21.
PIN_CATEGORY_EDS Aggiunta che fornisce Servizi dati estesi (riga 21, anche campi).
PIN_CATEGORY_NABTS Aggiungere i dati Standard videotext del Nord America.
PIN_CATEGORY_PREVIEW Pin di anteprima.
PIN_CATEGORY_STILL Pin 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 Aggiungere il teletext (variante di didascalia chiusa).
PIN_CATEGORY_TIMECODE Aggiungere i dati di timecode.
PIN_CATEGORY_VBI Aggiungere che fornisce dati di intervallo di spaziatura verticale.
PIN_CATEGORY_VIDEOPORT Pin di output video da connettere al pin di input zero nel mixer di sovrapposizione.
PIN_CATEGORY_VIDEOPORT_VBI Aggiungere per essere connesso all'allocatore Surface VBI, il filtro allocatore di superficie VBI necessario per allocare la memoria video corretta per elementi come sovrapposizioni di sottotitoli negli 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 hardware con didascalia chiusa

 

Questa proprietà è di sola lettura.

Codice di esempio

Il codice seguente mostra come verificare se un pin supporta questo set di proprietà e, in caso affermativo, 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