KSPROPERTY_RTAUDIO_CLOCKREGISTER

La propiedad KSPROPERTY_RTAUDIO_CLOCKREGISTER asigna el registro de reloj del reloj del dispositivo de audio a una ubicación de memoria virtual a la que el cliente puede acceder.

En la tabla siguiente se resumen las características de esta propiedad.

Tabla de resumen de uso

Obtener	Set	Destino	Tipo de descriptor de propiedad	Tipo de valor de propiedad
Sí	No	Anclar	KSRTAUDIO_HWREGISTER_PROPERTY	KSRTAUDIO_HWREGISTER

El descriptor de propiedad (datos de instancia) consta de una estructura KSRTAUDIO_HWREGISTER_PROPERTY que contiene una estructura KSPROPERTY . Antes de enviar la solicitud, el cliente carga la estructura de KSRTAUDIO_HWREGISTER_PROPERTY con valores que indican la dirección base preferida para el registro del reloj.

El valor de propiedad (datos de operación) es un puntero a una estructura de KSRTAUDIO_HWREGISTER en la que el controlador de propiedades escribe la dirección de registro y la frecuencia de actualización del registro. Esta dirección de registro es la dirección virtual en modo de usuario o modo kernel en la que se asigna el registro de hardware. El cliente puede leer directamente el registro de esta dirección.

Valor devuelto

Una solicitud de propiedad KSPROPERTY_RTAUDIO_CLOCKREGISTER devuelve STATUS_SUCCESS para indicar que se ha completado correctamente. De lo contrario, la solicitud devuelve un código de error que indica un error.

Observaciones

Algunos dispositivos de audio contienen registros de reloj. Un registro de reloj es un contador de reloj que comienza a ejecutarse cuando el hardware se enciende y se detiene cuando el hardware se apaga. El software usa registros de reloj para sincronizar entre dos o más dispositivos de controlador midiendo el desfase relativo entre los relojes de hardware del dispositivo.

Si se ejecuta correctamente, la solicitud de propiedad asigna el registro del reloj a una dirección de memoria virtual a la que se puede acceder desde el modo de usuario o el modo kernel, según lo especificado por el cliente. A partir de entonces, el cliente lee de esta dirección para obtener el valor actual del registro del reloj.

Se produce un error en la solicitud de propiedad si el hardware de audio no admite un registro de reloj que se puede asignar a la memoria virtual.

La asignación del registro de reloj se destruye cuando se cierra la patilla. El cliente solo puede asignar el registro una vez durante la vigencia de una instancia de pin y cualquier llamada posterior para asignar el registro del reloj de nuevo para esa instancia produce un error.

Normalmente es más rápido leer un registro de reloj que enviar una solicitud de KSPROPERTY_CLOCK_TIME , lo que requiere transiciones entre el modo de usuario y el modo kernel para los clientes en modo de usuario.

Requisitos

Versión	Disponible en Windows Vista y en sistemas operativos Windows posteriores.
Encabezado	Ksmedia.h

Vea también

KSRTAUDIO_HWREGISTER_PROPERTY

KSRTAUDIO_HWREGISTER