Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
No Windows XP Service Pack 1, a Microsoft definiu três conjuntos de propriedades de transmissão de núcleo e uma enumeração em ksmedia.h para suportar dispositivos codificadores de vídeo exclusivamente. Cada conjunto de propriedades contém uma única propriedade. Em outras palavras, cada propriedade recebe seu próprio conjunto de propriedades. Se o driver fizer chamadas Get-property ou Set-property, especifique o GUID do conjunto de propriedades (conforme definido em ksmedia.h) no membro Set da estrutura KSPROPERTY e insira zero no membro Id ao configurar a chamada:
| Definir Propriedade | Descrição |
|---|---|
| ENCAPIPARAM_BITRATE | Implemente esse conjunto de propriedades para especificar as taxas de bits de codificação compatíveis com o dispositivo codificador. Consulte exemplos de código do codificador para obter mais detalhes. |
| ENCAPIPARAM_BITRATE_MODE | Implemente esse conjunto de propriedades para especificar os modos de codificação compatíveis com o dispositivo. Esse conjunto de propriedades usa a enumeração VIDEOENCODER_BITRATE_MODE para especificar os modos com suporte. Consulte exemplos de código do codificador para obter mais detalhes. |
| ENCAPIPARAM_PEAK_BITRATE | Implemente esse conjunto de propriedades para especificar a taxa máxima de bits de codificação do dispositivo. |
Os clientes acessam essas propriedades derivando a interface COM IVideoEncoder da interface COM IEncoderAPI (descrita na documentação do SDK (Windows Software Development Kit).
Um minidriver deve especificar valores padrão para cada uma das propriedades ENCAPIPARAM_Xxx . O tópico exemplos de código do codificador demonstra como especificar valores de propriedade padrão. Durante o desenvolvimento e depuração de um filtro de codificação, a página de propriedades atual pode ser ativada a partir de um minidriver que suporta o conjunto de propriedades ENCAPIPARAM_BITRATE.
No DirectX 9.0, seis conjuntos de propriedades adicionais e um conjunto de eventos foram definidos em ksmedia.h para fornecer melhor suporte para uma variedade maior de codificadores, incluindo codificadores somente áudio. Assim como acontece com as propriedades ENCAPIPARAM_Xxx , cada propriedade recebe seu próprio conjunto de propriedades:
| Definir Propriedade | Descrição |
|---|---|
| CODECAPI_VIDEO_ENCODER | Se o dispositivo der suporte à codificação de fluxos de vídeo (incluindo áudio auxiliar, como áudio de TV), implemente o suporte para esse conjunto de propriedades. |
| CODECAPI_AUDIO_ENCODER | Se o dispositivo for um codificador somente áudio, implemente o suporte para esse conjunto de propriedades em vez de CODECAPI_VIDEO_ENCODER. |
| CODECAPI_SETALLDEFAULTS | Implemente esse conjunto de propriedades para redefinir todas as configurações internas do dispositivo codificador, como taxa de bits de codificação e modo de codificação para seus valores padrão. |
| CODECAPI_ALLSETTINGS | Implemente esse conjunto de propriedades para comunicar as configurações atuais do dispositivo codificador. Esse conjunto de propriedades é usado para comunicação com os clientes. |
| CODECAPI_SUPPORTSEVENTS | Se o dispositivo der suporte a eventos do modo de usuário, como alterar o modo de codificação, a taxa de bits ou outras configurações, implemente esse conjunto de propriedades. Se você implementar esse conjunto de propriedades, também deverá implementar o suporte para o evento CODECAPI_CHANGELISTS. |
| CODECAPI_CURRENTCHANGELIST | Implemente esse conjunto de propriedades para determinar quais parâmetros do codificador foram alterados em uma chamada anterior para definir uma ou mais propriedades do codificador. |
| Conjunto de Eventos | Descrição |
|---|---|
Se o dispositivo der suporte à resposta a eventos de modo de usuário por meio do conjunto de propriedades CODECAPI_SUPPORTSEVENTS, implemente esse conjunto de eventos para retornar uma lista de configurações do codificador que foram alteradas como resultado da chamada de propriedade set anterior de um cliente para CODECAPI_SETALLDEFAULTS ou CODECAPI_ALLSETTINGS. |
Os clientes acessam essas propriedades por meio da interface COM ICodecAPI (descrita na documentação do SDK do Windows). Consulte Instalação e Registro do Codificador para obter mais informações sobre as interfaces COM, incluindo como especificar qual interface KsProxy deve expor.
Um minidriver deve implementar o suporte para consultas básicas de propriedades "get". Os exemplos de código do codificador no tópico demonstram como dar suporte a consultas de propriedade de acesso.
Ao desenvolver um filtro de codificador, mova a funcionalidade de codificação para um filtro separado de um filtro de captura de vídeo. Defina seus próprios meios privados para que os construtores de grafos possam conectar corretamente o codificador e capturar filtros. Se o seu hardware for capaz de controlar conteúdo não codificado via bus, você também poderá disponibilizar meios públicos. Se você implementar meios públicos e privados, liste os meios privados primeiro porque isso reduz o tempo de construção do grafo; para localizar o filtro correto ao criar um grafo de filtro.
Para obter mais informações sobre como usar médias e várias instâncias de um filtro (em grafos de filtro separados), consulte Médias e Categorias.