Udostępnij przez


Zestawy właściwości kodera

W tej sekcji opisano zestawy właściwości specyficznych dla kodera i kodera interfejsu API, które są dostępne dla minidriverów korzystających z usług przesyłania strumieniowego jądra WDM w systemach Microsoft Windows 98/Me, Windows 2000 i Windows XP i nowszych.

Strona referencyjna dla każdej właściwości zawiera tabelę z nagłówkami kolumn, które są pokazane poniżej.

Get Set Target Typ deskryptora właściwości Typ wartości właściwości

Te nagłówki mają następujące znaczenie:

  • Get

    Czy docelowy obiekt KS obsługuje żądanie właściwości KSPROPERTY_TYPE_GET?

  • Set

    Czy docelowy obiekt KS obsługuje żądanie właściwości KSPROPERTY_TYPE_SET?

  • Target

    Jest to obiekt KS, do którego jest wysyłane żądanie właściwości. Elementem docelowym właściwości kodera wideo jest filtr lub pinezka. (Żądanie właściwości określa obiekt docelowy za pomocą uchwytu jądra).

  • Typ deskryptora właściwości

    Deskryptor właściwości określa właściwość i operację do wykonania na tej właściwości. The descriptor always begins with a KSPROPERTY structure.

  • Typ wartości właściwości

    Właściwość ma wartość, a typ tej wartości zależy od właściwości. Na przykład właściwość, która może znajdować się w jednym z dwóch stanów — lub poza nimi — zwykle ma wartość BOOL. Właściwość, która może przyjąć wartości całkowite z 0x0 do 0xFFFFFFFF, może mieć wartość ULONG. Bardziej złożone właściwości mogą mieć wartości, które są tablicami lub strukturami.

Deskryptor właściwości i wartość właściwości powyżej to wersje specyficzne dla właściwości specyfikacji wystąpienia i danych operacji, które zostały omówione w temacie Właściwości, Zdarzenia i Metody KS.

Żądanie właściwości używa jednej z następujących flag, aby określić operację, która ma zostać wykonana na właściwości:

  • KSPROPERTY_TYPE_BASICSUPPORT

  • KSPROPERTY_TYPE_GET

  • KSPROPERTY_TYPE_SET

Wszystkie obiekty filtru i przypinania obsługują operację podstawowej obsługi ich właściwości. 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.

Tabela w opisie każdej właściwości wskazuje, czy minidrivery kodera wideo są wymagane do obsługi odczytu lub zapisywania właściwości. Minidrivery kodera wideo powinny zwrócić STATUS_NOT_SUPPORTED w odpowiedzi na żądanie lub ustawić żądania dotyczące właściwości, które nie są obsługiwane przez minidriver.

Poniższe zestawy właściwości zawierają jedną właściwość, która musi być zaimplementowana przez minidrivery kodera wideo. 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.

Następujące zestawy właściwości należą do interfejsu API kodera:

CODECAPI_VIDEO_ENCODER

CODECAPI_AUDIO_ENCODER

CODECAPI_SETALLDEFAULTS

CODECAPI_ALLSETTINGS

CODECAPI_SUPPORTSEVENTS

CODECAPI_CURRENTCHANGELIST

Następujące zestawy właściwości należą do interfejsu API kodera:

ENCAPIPARAM_BITRATE

ENCAPIPARAM_BITRATE_MODE

ENCAPIPARAM_PEAK_BITRATE