Atributos do Media Foundation para objetos de cabeçalho ASF
O objeto de cabeçalho ASF de nível superior para um arquivo contém vários objetos de sub-cabeçalho ASF. O objeto ContentInfo armazena informações de todos esses Objetos de Cabeçalho e expõe determinados valores a um aplicativo por meio de atributos.
Objeto File Properties
Esse objeto de cabeçalho está presente em todos os arquivos ASF. Esses campos descrevem os atributos no nível do arquivo de toda a apresentação. A tabela a seguir lista os campos no Objeto Propriedades do Arquivo e nos atributos do descritor de apresentação correspondentes.
| Campo Objeto Propriedades do Arquivo | Atributo descritor de apresentação | Descrição |
|---|---|---|
| ID do Arquivo | MF_PD_ASF_FILEPROPERTIES_FILE_ID | Identificador exclusivo para este arquivo. |
| Tamanho do arquivo | MF_PD_TOTAL_FILE_SIZE | Tamanho do arquivo, em bytes. |
| Data de Criação | MF_PD_ASF_FILEPROPERTIES_CREATION_TIME | A data e hora de criação do arquivo. |
| Contagem de pacotes de dados | MF_PD_ASF_FILEPROPERTIES_PACKETS | Número de pacotes de dados no objeto de dados ASF. |
| Duração da Reprodução | MF_PD_ASF_FILEPROPERTIES_PLAY_DURATION | Tempo necessário para reproduzir o arquivo, em unidades de 100 nanossegundos. Esse valor inclui o tempo de pré-registro. |
| Duração do Envio | MF_PD_ASF_FILEPROPERTIES_SEND_DURATION | Tempo necessário para enviar o arquivo, em unidades de 100 nanossegundos. |
| Preroll | MF_PD_ASF_FILEPROPERTIES_PREROLL | Período de tempo para armazenar dados em buffer antes de reproduzir o arquivo, em unidades de 100 nanossegundos. |
| Flags | MF_PD_ASF_FILEPROPERTIES_FLAGS | Sinalizadores que indicam se o arquivo é difundido ou pesquisável. |
| Tamanho mínimo do pacote de dados | MF_PD_ASF_FILEPROPERTIES_MIN_PACKET_SIZE | Tamanho mínimo dos pacotes de dados no arquivo, em bytes. |
| Tamanho máximo do pacote de dados | MF_PD_ASF_FILEPROPERTIES_MAX_PACKET_SIZE | Tamanho máximo dos pacotes de dados no arquivo, em bytes. |
| Taxa máxima de bits | MF_PD_ASF_FILEPROPERTIES_MAX_BITRATE | Taxa máxima de bits instantâneos, em bits por segundo. |
Objeto Stream Properties
Esse objeto de cabeçalho descreve as propriedades dos fluxos no arquivo ASF. No Media Foundation, isso é gerenciado pelo objeto de perfil e pelo objeto de configuração de fluxo. Para obter mais informações, consulte Criando e configurando fluxos ASF.
Objeto Codec List
Se esse objeto de cabeçalho estiver presente, o atributo MF_PD_ASF_CODECLIST fornecerá uma lista de codecs que foram usados para codificar os fluxos no arquivo ASF. Cada fluxo deve ter suas informações de codec neste objeto.
Objeto Script Command
Se esse objeto de cabeçalho estiver presente, ele especificará uma lista de comandos de script com suporte no arquivo ASF. Um comando de script consiste em um tipo de comando, um nome de comando e um horário de apresentação. O tipo de comando e o nome do comando são cadeias de caracteres largos. Esses comandos podem ser usados para notificar o cliente para executar uma ação em um determinado ponto da apresentação. Por exemplo, um aplicativo pode usar o tipo de comando "FILENAME" para reproduzir uma sequência contínua de arquivos ASF.
Para obter a lista de comandos de script, obtenha o atributo MF_PD_ASF_SCRIPT do descritor de apresentação. Um aplicativo deve recuperar todos os comandos de script antes de iniciar a reprodução.
Objeto Marker
Um marcador é um indicador dentro de um arquivo ASF. Um aplicativo pode usar marcadores para buscar vários pontos dentro do conteúdo. Cada marcador consiste em um nome de marcador, o tempo de apresentação associado e o deslocamento do início do arquivo. O atributo MF_PD_ASF_MARKER fornece uma lista de marcadores disponíveis para o arquivo.
Objeto Propriedades de Taxa de Bits de Fluxo
Esse cabeçalho armazena a taxa média de bits de cada fluxo presente no arquivo ASF. Esse valor é armazenado no descritor de fluxo para o fluxo no atributo MF_SD_ASF_STREAMBITRATES_BITRATE .
Objeto de criptografia de conteúdo
Esse objeto de cabeçalho estará presente se o provedor de conteúdo tiver protegido o conteúdo usando o Microsoft Digital Rights Management. A tabela a seguir lista os campos no Objeto de Criptografia de Conteúdo e nos atributos do descritor de apresentação correspondentes:
| Campo Objeto de Criptografia de Conteúdo | Atributo descritor de apresentação | Descrição |
|---|---|---|
| Dados secretos | MF_PD_ASF_CONTENTENCRYPTION_SECRET_DATA | Matriz de bytes que contém dados secretos. |
| Tipo de proteção | MF_PD_ASF_CONTENTENCRYPTION_TYPE | Cadeia de caracteres terminada em nulo que tem o valor "DRM". |
| Identificação da Chave | MF_PD_ASF_CONTENTENCRYPTION_KEYID | Cadeia de caracteres terminada em nulo que descreve o identificador de chave. |
| URL de licença | MF_PD_ASF_CONTENTENCRYPTION_LICENSE_URL | Cadeia de caracteres terminada em nulo que contém a URL da qual adquirir a licença para usar o conteúdo. |
Objeto de criptografia de conteúdo estendido
Esse objeto de cabeçalho estará presente se o provedor de conteúdo tiver protegido o conteúdo usando o SDK do Windows Media Rights Manager 7. O atributo MF_PD_ASF_CONTENTENCRYPTION_LICENSE_URL fornece uma matriz de bytes que corresponde ao campo Dados do objeto de cabeçalho. Esse campo é necessário para usar o conteúdo.
Objeto Extended Stream Properties
Esse cabeçalho faz parte do Objeto de Extensão de Cabeçalho. O Objeto Propriedades de Fluxo Estendido fornece propriedades do fluxo que não são definidas no Objeto Propriedades do Stream. Essas propriedades são usadas principalmente para determinar os parâmetros de "bucket com vazamento", que são usados pelo decodificador. Essas propriedades também são usadas pelo codificador ao compactar dados. Isso é gerenciado pelo objeto de perfil e pelo objeto de configuração de fluxo. Para obter mais informações, consulte Criando e configurando fluxos ASF.
A tabela a seguir lista os campos Objetos de Propriedades de Fluxo Estendido e os atributos de descritor de fluxo correspondentes.
| Campo Propriedades do Fluxo Estendido | Atributo do descritor de fluxo | Descrição |
|---|---|---|
| Taxa de Bits de Dados | MF_SD_ASF_EXTSTRMPROP_AVG_DATA_BITRATE | Taxa média de dados, em bits por segundo. |
| Tamanho do Buffer | MF_SD_ASF_EXTSTRMPROP_AVG_BUFFERSIZE | Tamanho do bucket com vazamento. Valor é o número de milissegundos de dados que podem caber no buffer na taxa média de dados. |
| Taxa de Bits de Dados Alternativa | MF_SD_ASF_EXTSTRMPROP_MAX_DATA_BITRATE | Taxa de dados de pico, em mordidas por segundo. A taxa de dados de pico é usada para fluxos com uma taxa de bits variável. |
| Tamanho alternativo do buffer | MF_SD_ASF_EXTSTRMPROP_MAX_BUFFERSIZE | Tamanho máximo do bucket com vazamento. Valor é o número de milissegundos de dados que podem caber no buffer na taxa de dados de pico. |
| ID do Idioma do Stream | MF_SD_ASF_EXTSTRMPROP_LANGUAGE_ID_INDEX | O idioma que o fluxo usa, especificado como um índice na lista de idiomas no Objeto de Lista de Idiomas. |
Objeto Language List
Esse objeto de cabeçalho faz parte do Objeto de Extensão de Cabeçalho. Se presente, o atributo MF_PD_ASF_LANGLIST fornece uma lista de identificadores de idioma com suporte no arquivo. Os identificadores estão em conformidade com o RFC 1766 para especificar idiomas.
Objeto de exclusão mútua
Esse cabeçalho especifica grupos de fluxos e suas propriedades, sendo que apenas um deles será entregue por vez. Para obter mais informações, consulte Usando a exclusão mútua para fluxos ASF.
Tópicos relacionados