Método IDvdInfo2::GetAllSPRMs (strmif.h)

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O método GetAllSPRMs recupera o conteúdo atual de todos os SPRMs (registros de parâmetros do sistema).

Sintaxe

HRESULT GetAllSPRMs(
  [out] SPRMARRAY *pRegisterArray
);

Parâmetros

[out] pRegisterArray

Ponteiro para uma matriz do tipo SPRMARRAY que recebe o endereço de uma matriz de SPRMs.

Retornar valor

Retorna um dos seguintes valores HRESULT .

Código de retorno Descrição
S_OK
Êxito.
E_POINTER
Argumento inválido.

Comentários

Os 24 SPRMs são usados para armazenar informações sobre o idioma atual, a subpictura e outros dados de navegação.

Nota Um aplicativo player não precisa acessar esses registros somente leitura para qualquer funcionalidade de navegação padrão. Para usar esses registros com eficiência, você provavelmente precisará de um conhecimento mais detalhado dos comandos de navegação de DVD do que o fornecido nesta documentação. A tabela a seguir lista o conteúdo de cada registro. Os bits dentro da palavra são chamados de b0 (bit de ordem baixa) até b15 (bit de ordem alta).
 
Registre-se Sumário
0 Código de idioma ISO-639 (duas letras ASCII minúsculas). O valor padrão é indefinido.
1 4 bits baixos (b0-b3) contêm número de fluxo de áudio (0 a 7) ou 15 (nenhum). O valor padrão é de 15.
2 6 bits baixos (b0-b5) contêm o número de fluxo de subpictura (0 a 31) ou 62 (nenhum) ou 63 (fluxo fictício para subpictura forçada). O 7º bit (b6) contém o sinalizador de exibição de subpictura (0 = não exibir subpictura). O valor padrão é 62.
3 4 bits baixos (b0-b3) contêm número de ângulo (1 a 9). O valor padrão é 1.
4 7 bits baixos (b0-b6) contêm número de título (1 a 99). O valor padrão é 1.
5 7 bits baixos (b0-b6) contêm o número de título dentro do VTS atual (1 a 99). O valor padrão é 1.
6 15 bits baixos (b0-b14) contêm o número do PGC no título atual (1 a 32767). O valor padrão é indefinido.
7 10 bits baixos (b0-b9) contêm o número do capítulo (1 a 99). O valor padrão é 1. Valor indefinido, a menos que o título seja one_sequential_PGC_title.
8 6 bits altos (b10-b15) contêm o número do botão (1 a 36). O valor padrão é 1024 (botão 1).
9 Contagem de temporizador, em segundos (0 a 65535). O valor padrão é 0.
10 15 bits baixos (b0-b14) contêm o número do PGC no título atual (1 a 32767). O valor padrão é indefinido.
11 Seis sinalizadores (b2: mix ch2 a ch1, b3: mix ch3 to ch1, b4: mix ch4 to ch1, b10 mix ch2 to ch0, b11: mix ch3 to ch0, b12: mix ch4 to ch0). O valor do sinalizador de 0 significa que não se misture. O valor padrão para todos os sinalizadores é 0. Valor indefinido se não estiver reproduzindo o fluxo do Karaoke.
12 Código de país/região ISO-3166 (duas letras ASCII maiúsculas) ou 65535 (não especificado). O valor padrão é indefinido.
13 4 bits baixos (b0-b3) contêm nível parental (1 a 8) ou 15 (nenhum). O valor padrão é indefinido.
14 b8-b9 contêm o modo de saída de vídeo atual (0 = normal [4:3 ou 16:9], 1 = panscan, 2 = caixa de correio). b10-b11 contêm o modo de exibição preferencial (0 = 4:3, 3 = 16:9). O valor padrão é indefinido.
15 Nove bandeiras (b2: SDDS karaokê, b3: DTS karaoke, b4: MPEG karaoke, b6: Dolby Digital karaoke, b7: PCM karaoke, b10: reprodução SDDS, b11: reprodução DTS, b12: reprodução MPEG, b14: reprodução do Dolby Digital). O valor de sinalizador de 0 significa incapaz, 1 significa capaz. O valor padrão é indefinido.
16 Código de idioma ISO-639 (duas letras ASCII minúsculas) ou 65535 (não especificado). O valor padrão é 65535.
17 Código de extensão de linguagem (0 = não especificado, 1 = áudio normal, 2 = áudio para deficientes visuais, 3 = comentários de diretor nº 1, 4 = comentários de diretor #2). O valor padrão é 0.
18 Código de idioma ISO-639 (duas letras ASCII minúsculas) ou 65535 (não especificado). O valor padrão é 65535.
19 Código de extensão de linguagem (0 = não especificado, 1 = legendas normais, 2 = legendas grandes, 3 = legendas para filhos, 5 = legendas ocultas normais, 6 = legendas ocultas grandes, 7 = Legendas ocultas para crianças, 9 = legendas forçadas, 13 = comentários de diretor, 14 = comentários de diretor grande, 15 = comentários de diretor para crianças). O valor padrão é 0.
20 8 bits baixos (b0-b7) contêm código de região (1 a 8).

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho strmif.h (inclua Dshow.h)
Biblioteca Strmiids.lib

Confira também

Aplicativos de DVD

Códigos de erro e êxito

IDvdInfo2 Interface