Delen via

Eigenschapsset vastmaken

  • Artikel

[De functie die is gekoppeld aan deze pagina, DirectShow, is een verouderde functie. Het is vervangen door MediaPlayer, IMFMediaEngineen Audio/Video Capture in Media Foundation. Deze functies zijn geoptimaliseerd voor Windows 10 en Windows 11. Microsoft raadt ten zeerste aan om nieuwe code te gebruiken MediaPlayer, IMFMediaEngine en Audio/Video Capture in Media Foundation in plaats van DirectShow, indien mogelijk. Microsoft stelt voor dat bestaande code die gebruikmaakt van de verouderde API's, indien mogelijk opnieuw worden geschreven om de nieuwe API's te gebruiken.]

De pincodeeigenschapsset retourneert de pincodecategorie voor een speld op een filter. De categorie wordt ingesteld door het filter wanneer deze de pin maakt; de categorie geeft aan welk type gegevens de pincode wordt afgeleverd of ontvangen door deze pincode.

Etiket Waarde
GUID van eigenschappenset AMPROPSETID_Pin

 

Eigenschaps-id Beschrijving
AMPROPERTY_PIN_CATEGORY Hiermee geeft u de categorie van een speld op.

 

DirectShow definieert de volgende pincodecategorieën in het headerbestand Uuids.h.

Categorie-GUID Beschrijving
PIN_CATEGORY_ANALOGVIDEOIN Invoerpin van het opnamefilter dat analoog wordt gebruikt en digitaliseert.
PIN_CATEGORY_CAPTURE Vastmaken pin.
PIN_CATEGORY_CC Maak een speld voor ondertitelingsgegevens van regel 21.
PIN_CATEGORY_EDS Vastmaken aan uitgebreide gegevensservices (regel 21, zelfs velden).
PIN_CATEGORY_NABTS Pin providing North American Videotext Standard data.
PIN_CATEGORY_PREVIEW Voorbeeldpincode.
PIN_CATEGORY_STILL Pin die een still afbeelding biedt. De vastlegpin van het filter moet zijn verbonden voordat de pincode voor de still-image is verbonden.
PIN_CATEGORY_TELETEXT Teletekst vastmaken (een variant voor ondertiteling).
PIN_CATEGORY_TIMECODE Maak tijdcodegegevens vast.
PIN_CATEGORY_VBI Vastmaken voor het opgeven van gegevens over het interval voor verticale lege waarden.
PIN_CATEGORY_VIDEOPORT Video-uitvoerpin die moet worden verbonden met invoerpin nul op de Overlay Mixer.
PIN_CATEGORY_VIDEOPORT_VBI Pin to be connected to the VBI Surface Allocator, het VBI surface allocator filter dat nodig is om het juiste videogeheugen toe te wijzen voor zaken zoals ondertiteling overlays in scenario's waarin een videopoort wordt gebruikt. Pci-, IEEE 1394- en USB-scenario's gebruiken dit filter niet.
PINNAME_VIDEO_CC_CAPTURE Ondertitelingspin voor ondertiteling van hardware

 

Deze eigenschap heeft het kenmerk Alleen-lezen.

Voorbeeldcode

De volgende code laat zien hoe u kunt controleren of een pincode deze eigenschapsset ondersteunt en hoe u de pincodecategorie kunt verkrijgen:

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

Notitie

In dit voorbeeld wordt de functie SafeRelease gebruikt om interfaceaanwijzers vrij te geven.

 

vereisten vastmaken voor capturefilters

eigenschappensets

Werken met categorieën vastmaken