Sady vlastností kodéru

Tato část popisuje sady vlastností specifické pro kodér a kodeky, které jsou k dispozici pro minidrivery kodéru, které používají služby streamování jádra WDM v systému Microsoft Windows 98/Me, Windows 2000 a Windows XP a novější.

Referenční stránka pro každou vlastnost obsahuje tabulku s záhlavími sloupců, které jsou uvedeny níže.

Get Set Target Typ popisovače vlastnosti Typ hodnoty vlastnosti

Tyto nadpisy mají následující významy:

  • Get

    Podporuje cílový objekt KS požadavek na vlastnost KSPROPERTY_TYPE_GET?

  • Set

    Podporuje cílový objekt KS požadavek na vlastnost KSPROPERTY_TYPE_SET?

  • Target

    Toto je objekt KS, do kterého se odešle požadavek na vlastnost. Cílem vlastnosti kodéru videa je filtr nebo špendlík. (Požadavek na vlastnost určuje cílový objekt popisovačem jádra.)

  • Typ popisovače vlastnosti

    Popisovač vlastnosti určuje vlastnost a operaci, která se má provést s danou vlastností. The descriptor always begins with a KSPROPERTY structure.

  • Typ hodnoty vlastnosti

    Vlastnost má hodnotu a typ této hodnoty závisí na vlastnosti. Například vlastnost, která může být v jednom ze dvou stavů - on nebo off-- obvykle má hodnotu BOOL. Vlastnost, která může předpokládat celočíselné hodnoty z 0x0 do 0xFFFFFFFF může mít hodnotu ULONG. Složitější vlastnosti můžou mít hodnoty, které jsou maticemi nebo strukturami.

Popisovač vlastností a výše uvedená hodnota vlastnosti jsou verze specifické pro vlastnost specifikace instance a vyrovnávací paměti dat operací, které jsou popsány v KS Properties, Events a Methods.

Požadavek na vlastnost používá jeden z následujících příznaků k určení operace, která se má provést u vlastnosti:

  • KSPROPERTY_TYPE_BASICSUPPORT

  • KSPROPERTY_TYPE_GET

  • KSPROPERTY_TYPE_SET

Všechny objekty filtru a připnutí podporují operaci základní podpory jejich vlastností. Whether they support the get and Set operations depends on the property. A property that represents an inherent capability of the filter or pin object is likely to require only a get operation. A property that represents a configurable setting might require only a Set operation, although a get operation might also be useful for reading the current setting. For more information about using the get, set, and basic-support operations with video encoder properties, see KS Properties.

Tabulka v popisu každé vlastnosti označuje, jestli jsou minidrivery video kodéru nutné k podpoře čtení nebo zápisu vlastnosti. Minidrivery kodéru videa by měly v reakci na získání nebo nastavení požadavků na vlastnosti, které minidriver nepodporuje, vrátit STATUS_NOT_SUPPORTED.

Následující sady vlastností obsahují jednu vlastnost, která musí být implementována minidrivery kodéru videa. That is, effectively each property gets its own set, so specify 0 in the PropertyId member of the KSPROPERTY_ITEM member in the KSPROPERTY_SET structure as required.

Následující sady vlastností patří do rozhraní API kodeku:

CODECAPI_VIDEO_ENCODER

CODECAPI_AUDIO_ENCODER

CODECAPI_SETALLDEFAULTS

CODECAPI_ALLSETTINGS

CODECAPI_SUPPORTSEVENTS

CODECAPI_CURRENTCHANGELIST

Následující sady vlastností patří do rozhraní API kodéru:

ENCAPIPARAM_BITRATE

ENCAPIPARAM_BITRATE_MODE

ENCAPIPARAM_PEAK_BITRATE