Aracılığıyla paylaş


Kodlayıcı Özellik Kümeleri

Bu bölümde, Microsoft Windows 98/Me, Windows 2000 ve Windows XP ve sonraki sürümlerde WDM çekirdek akış hizmetlerini kullanan kodlayıcı minidriver'lar için kullanılabilen kodlayıcı ve codec API'sine özgü özellik kümeleri açıklanmaktadır.

Her özelliğin başvuru sayfası, aşağıda gösterilen sütun başlıklarını içeren bir tablo içerir.

Get Set Target Özellik tanımlayıcı türü Özellik değeri türü

Bu başlıklar aşağıdaki anlamlara sahiptir:

  • Get

    Hedef KS nesnesi KSPROPERTY_TYPE_GET özellik isteğini destekliyor mu?

  • Set

    Hedef KS nesnesi KSPROPERTY_TYPE_SET özellik isteğini destekliyor mu?

  • Target

    Bu, özellik isteğinin gönderildiği KS nesnesidir. Video kodlayıcı özelliğinin hedefi bir filtre veya raptiyedir. (Özellik isteği, hedef nesneyi çekirdek tutamacıyla belirtir.)

  • Özellik tanımlayıcı türü

    Özellik tanımlayıcısı, özelliği ve bu özellik üzerinde gerçekleştirilecek işlemi belirtir. The descriptor always begins with a KSPROPERTY structure.

  • Özellik değeri türü

    Özelliğin bir değeri vardır ve bu değerin türü özelliğine bağlıdır. Örneğin, yalnızca iki durumdan birinde (açık veya kapalı) bulunabilen bir özelliğin genellikle bool değeri vardır. 0x0 ile 0xFFFFFFFF arasında tamsayı değerleri varsayabilen bir özelliğin ULONG değeri olabilir. Daha karmaşık özelliklerin dizi veya yapı değerleri olabilir.

Yukarıdaki özellik tanımlayıcısı ve özellik değeri , KS Özellikleri, Olayları ve Yöntemleri'nde ele alınan örnek belirtimi ve işlem verileri arabelleklerinin özelliğe özgü sürümleridir.

Özellik isteği, özelliğinde gerçekleştirilecek işlemi belirtmek için aşağıdaki bayraklardan birini kullanır:

  • KSPROPERTY_TYPE_BASICSUPPORT

  • KSPROPERTY_TYPE_GET

  • KSPROPERTY_TYPE_SET

Tüm filtre ve sabitleme nesneleri özelliklerinde temel destek işlemini destekler. 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.

Her özelliğin açıklamasındaki bir tablo, özelliğin okunmasını veya yazmasını desteklemek için video kodlayıcı minidriver'ların gerekli olup olmadığını gösterir. Video kodlayıcı minidriver'lar, mini sürücü tarafından desteklenmeyen özelliklere yönelik istekleri almak veya ayarlamak için yanıt olarak STATUS_NOT_SUPPORTED döndürmelidir.

Aşağıdaki özellik kümeleri, video kodlayıcı minidriver'lar tarafından uygulanması gereken tek bir özellik içerir. 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.

Aşağıdaki özellik kümeleri codec API'sine aittir:

CODECAPI_VIDEO_ENCODER

CODECAPI_AUDIO_ENCODER

CODECAPI_SETALLDEFAULTS

CODECAPI_ALLSETTINGS

CODECAPI_SUPPORTSEVENTS

CODECAPI_CURRENTCHANGELIST

Aşağıdaki özellik kümeleri kodlayıcı API'sine aittir:

ENCAPIPARAM_BITRATE

ENCAPIPARAM_BITRATE_MODE

ENCAPIPARAM_PEAK_BITRATE