KSPROPERTY_RTAUDIO_CLOCKREGISTER

A propriedade KSPROPERTY_RTAUDIO_CLOCKREGISTER mapeia o registro do relógio de parede do dispositivo de áudio em um local de memória virtual que o cliente pode acessar.

A tabela a seguir resume os recursos dessa propriedade.

Tabela de Resumo de Uso

O descritor de propriedade (dados da instância) consiste em uma estrutura KSRTAUDIO_HWREGISTER_PROPERTY que contém uma estrutura KSPROPERTY . Antes de enviar a solicitação, o cliente carrega a estrutura KSRTAUDIO_HWREGISTER_PROPERTY com valores que indicam o endereço base preferencial para o registro do relógio.

O valor da propriedade (dados de operação) é um ponteiro para uma estrutura KSRTAUDIO_HWREGISTER na qual o manipulador de propriedades grava o endereço de registro e a frequência de atualização de registro. Esse endereço de registro é o endereço virtual do modo de usuário ou do modo kernel no qual o registro de hardware é mapeado. O cliente pode ler diretamente o registro desse endereço.

Valor retornado

Uma solicitação de propriedade KSPROPERTY_RTAUDIO_CLOCKREGISTER retorna STATUS_SUCCESS para indicar que foi concluída com êxito. Caso contrário, a solicitação retornará um código de erro que indica uma falha.

Comentários

Alguns dispositivos de áudio contêm registros de relógio. Um registro de relógio é um contador de relógio de parede que começa a ser executado quando o hardware se alimenta e para quando o hardware é desligado. O software usa registros de relógio para sincronizar entre dois ou mais dispositivos controladores medindo o descompasso relativo entre os relógios de hardware do dispositivo.

Se bem-sucedida, a solicitação de propriedade mapeia o registro do relógio para um endereço de memória virtual acessível no modo de usuário ou no modo kernel, conforme especificado pelo cliente. Depois disso, o cliente lê desse endereço para obter o valor atual do registro do relógio.

A solicitação de propriedade falhará se o hardware de áudio não der suporte a um registro de relógio que possa ser mapeado para memória virtual.

O mapeamento do registro de relógio é destruído quando o pino é fechado. O cliente pode mapear o registro apenas uma vez no tempo de vida de uma instância de pino e qualquer chamada subsequente para mapear o registro do relógio novamente para essa instância falhará.

Normalmente, é mais rápido ler um registro de relógio do que enviar uma solicitação de KSPROPERTY_CLOCK_TIME , o que requer transições entre o modo de usuário e o modo kernel para clientes do modo de usuário.

Requisitos

Confira também

KSRTAUDIO_HWREGISTER_PROPERTY

KSRTAUDIO_HWREGISTER