Stap 3C. De methode CheckTransform implementeren

[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.]

Dit is stap 3C van de zelfstudie Het schrijven van transformatiefilters.

Notitie

Deze stap is niet vereist voor filters die zijn afgeleid van CTransInPlaceFilter.

 

De methode CTransformFilter::CheckTransform controleert of een voorgesteld uitvoertype compatibel is met het huidige invoertype. De methode wordt ook aangeroepen als de invoerpin opnieuw verbinding maakt nadat de uitvoerpin is verbonden.

In het volgende voorbeeld wordt gecontroleerd of de indeling RLE8-video is; de afmetingen van de afbeelding overeenkomen met de invoerindeling; en de paletvermeldingen zijn hetzelfde. Ook worden bron- en doelrechthoeken geweigerd die niet overeenkomen met de grootte van de afbeelding.

HRESULT CRleFilter::CheckTransform(
    const CMediaType *mtIn, const CMediaType *mtOut)
{
    // Check the major type.
    if (mtOut->majortype != MEDIATYPE_Video)
    {
        return VFW_E_TYPE_NOT_ACCEPTED;
    }

    // Check the subtype and format type.
    FOURCCMap fccMap = FCC('MRLE'); 
    if (mtOut->subtype != static_cast<GUID>(fccMap))
    {
        return VFW_E_TYPE_NOT_ACCEPTED;
    }
    if ((mtOut->formattype != FORMAT_VideoInfo) || 
        (mtOut->cbFormat < sizeof(VIDEOINFOHEADER)))
    {
        return VFW_E_TYPE_NOT_ACCEPTED;
    }

    // Compare the bitmap information against the input type.
    ASSERT(mtIn->formattype == FORMAT_VideoInfo);
    BITMAPINFOHEADER *pBmiOut = HEADER(mtOut->pbFormat);
    BITMAPINFOHEADER *pBmiIn = HEADER(mtIn->pbFormat);
    if ((pBmiOut->biPlanes != 1) ||
        (pBmiOut->biBitCount != 8) ||
        (pBmiOut->biCompression != BI_RLE8) ||
        (pBmiOut->biWidth != pBmiIn->biWidth) ||
        (pBmiOut->biHeight != pBmiIn->biHeight))
    {
        return VFW_E_TYPE_NOT_ACCEPTED;
    }

    // Compare source and target rectangles.
    RECT rcImg;
    SetRect(&rcImg, 0, 0, pBmiIn->biWidth, pBmiIn->biHeight);
    RECT *prcSrc = &((VIDEOINFOHEADER*)(mtIn->pbFormat))->rcSource;
    RECT *prcTarget = &((VIDEOINFOHEADER*)(mtOut->pbFormat))->rcTarget;
    if (!IsRectEmpty(prcSrc) && !EqualRect(prcSrc, &rcImg))
    {
        return VFW_E_INVALIDMEDIATYPE;
    }
    if (!IsRectEmpty(prcTarget) && !EqualRect(prcTarget, &rcImg))
    {
        return VFW_E_INVALIDMEDIATYPE;
    }

    // Check the palette table.
    if (pBmiOut->biClrUsed != pBmiIn->biClrUsed)
    {
        return VFW_E_TYPE_NOT_ACCEPTED;
    }
    DWORD cbPalette = pBmiOut->biClrUsed * sizeof(RGBQUAD);
    if (mtOut->cbFormat < sizeof(VIDEOINFOHEADER) + cbPalette)
    {
        return VFW_E_TYPE_NOT_ACCEPTED;
    }
    if (0 != memcmp(pBmiOut + 1, pBmiIn + 1, cbPalette))
    {
        return VFW_E_TYPE_NOT_ACCEPTED;
    }

    // Everything is good.
    return S_OK;
}

Herverbindingen van pennen

Toepassingen kunnen pinnen loskoppelen en opnieuw verbinden. Stel dat een toepassing beide pinnen verbindt, de invoerpin verbreekt en vervolgens de invoerpin opnieuw verbindt met behulp van een nieuwe afbeeldingsgrootte. In dat geval mislukt CheckTransform- omdat de afmetingen van de afbeelding niet meer overeenkomen. Dit gedrag is redelijk, hoewel het filter ook opnieuw verbinding kan maken met de uitvoerpin met een nieuw mediatype.

Volgende: stap 4. Allocatoreigenschappen instellen.

Pinnen opnieuw koppelen

Bron- en Doelrechthoeken in Videoweergaven

DirectShow-filters schrijven

 

 

  • Last updated on