Метод IKsClockPropertySet::KsGetState (ksproxy.h)

Статья
02/07/2025

Метод KsGetState извлекает состояние потоковой передачи пин-кода из базовых часов.

Синтаксис

HRESULT KsGetState(
  [out] KSSTATE *State
);

Параметры

[out] State

Указатель на переменную, которая получает значение, указывающее состояние потоковой передачи пин-кода. Это значение может быть одним из следующих значений из перечисленного типа KSSTATEKSSTATE:

Ценность	Описание
KSSTATE_STOP	Потоковая передача данных в пин-код или из нее останавливается. Представляет начальное состояние пин-кода с наименьшим использованием ресурсов и максимальной задержкой для получения состояния KSSTATE_RUN.
KSSTATE_ACQUIRE	Представляет состояние, с которыми согласовываются распределители и ресурсы, хотя данные в этом состоянии не буферизируются.
KSSTATE_PAUSE	Часы ожидают и готовы мгновенно изменить состояние KSSTATE_RUN. Представляет режим большинства использования ресурсов и наименьшую задержку в состоянии выполнения, не находясь в состоянии KSSTATE_RUN. Данные можно буферивировать в этом состоянии. Если состояние пин-кода запрашивается и это состояние приостановлено, пин-код может вернуть ошибку STATUS_NO_DATA_DETECTED, чтобы указать, что этот пин-код не выполняет очередь данных при приостановке.
KSSTATE_RUN	Закрепление — потоковая передача данных. То есть пин-код потребляет или создает потоковые данные.

Возвращаемое значение

Возвращает NOERROR в случае успешного выполнения; в противном случае возвращает код ошибки.

Замечания

Состояние пин-кода обеспечивает грубый контроль двигателя для пин-кодов. Тонкое управление двигателем выполняется на основе класса по классам с пользовательскими свойствами. Например, чтобы сделать внешний лазерный проигрыватель диска спиной, можно задать настраиваемое свойство Mode, относящееся к данному классу. Установка этого свойства также может изменить состояние устройства, хотя и не обязательно, в зависимости от эффекта режима.

Сам фильтр может поддерживать это свойство состояния, чтобы приложения могли задать состояние всего фильтра. В противном случае каждый пин-код должен иметь свой набор состояний. При переходе состояния закреплений из KSSTATE_STOP каждое подключение, которое перенаправит irPs, должно пересчитывать глубину стека.

Прокси-сервер использует свойство KSPROPERTY_CLOCK_STATE для получения состояния потоковой передачи пин-кода.

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	ksproxy.h (включая Ksproxy.h)

Поделиться через