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

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

Синтаксис

HRESULT KsGetState(
  [out] KSSTATE *State
);

Параметры

[out] State

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

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

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

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

Комментарии

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

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

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

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	ksproxy.h (включая Ksproxy.h)