KSPROPERTY_RTAUDIO_CLOCKREGISTER
Свойство KSPROPERTY_RTAUDIO_CLOCKREGISTER сопоставляет регистр настенных часов звукового устройства с расположением виртуальной памяти, к которому клиент может получить доступ.
В следующей таблице перечислены функции этого свойства.
Сводная таблица использования
| Получить | Присвойте параметру | Назначение | Тип дескриптора свойства | Тип значения свойства |
|---|---|---|---|---|
Да |
Нет |
Pin |
Дескриптор свойства (данные экземпляра) состоит из KSRTAUDIO_HWREGISTER_PROPERTY структуры, содержащей структуру KSPROPERTY . Перед отправкой запроса клиент загружает структуру KSRTAUDIO_HWREGISTER_PROPERTY со значениями, указывающими предпочтительный базовый адрес для регистра часов.
Значение свойства (данные операции) — это указатель на структуру KSRTAUDIO_HWREGISTER, в которую обработчик свойств записывает адрес регистра и частоту обновления регистра. Этот адрес регистра является виртуальным адресом в пользовательском режиме или режиме ядра, с которым сопоставляется аппаратный регистр. Клиент может напрямую считывать регистр по этому адресу.
Возвращаемое значение
Запрос свойства KSPROPERTY_RTAUDIO_CLOCKREGISTER возвращает STATUS_SUCCESS, указывающий на успешное выполнение. В противном случае запрос возвращает код ошибки, указывающий на сбой.
Комментарии
Некоторые звуковые устройства содержат регистры часов. Регистр часов — это счетчик настенных часов, который запускается, когда оборудование включается, и останавливается при выключении оборудования. Программное обеспечение использует регистры часов для синхронизации между двумя или более устройствами контроллера путем измерения относительного смещения между аппаратными часами устройства.
В случае успешного выполнения запрос свойства сопоставляет регистр часов с адресом виртуальной памяти, который доступен в пользовательском режиме или режиме ядра, как указано клиентом. После этого клиент считывает с этого адреса, чтобы получить текущее значение регистра часов.
Запрос свойства завершается ошибкой, если звуковое оборудование не поддерживает регистр часов, который можно сопоставить с виртуальной памятью.
Сопоставление регистра часов уничтожается при закрытии контакта. Клиент может сопоставить регистр только один раз за время существования экземпляра pin, и любой последующий вызов сопоставления регистра часов для этого экземпляра завершается ошибкой.
Обычно считывать регистр часов быстрее, чем отправлять запрос KSPROPERTY_CLOCK_TIME , который требует перехода между пользовательским режимом и режимом ядра для клиентов в пользовательском режиме.
Требования
Версия |
Доступно в операционных системах Windows Vista и более поздних версий. |
Заголовок |
Ksmedia.h |