Método IKsClockPropertySet::KsGetState (ksproxy.h)

El método KsGetState recupera el estado de streaming de un pin del reloj subyacente.

Sintaxis

HRESULT KsGetState(
  [out] KSSTATE *State
);

Parámetros

[out] State

Puntero a una variable que recibe un valor que especifica el estado de streaming de un pin. Este valor puede ser uno de los siguientes valores del tipo enumerado KSSTATE :

Valor	Descripción
KSSTATE_STOP	El streaming de datos hacia o desde la patilla se detiene. Representa el estado inicial del pin con el menor uso de recursos y la mayor latencia para obtener un estado de KSSTATE_RUN .
KSSTATE_ACQUIRE	Representa el estado en el que se negocian los asignadores y se adquieren recursos, aunque no se pueden almacenar en búfer datos en este estado.
KSSTATE_PAUSE	El reloj está esperando y está preparado para cambiar al instante al estado KSSTATE_RUN . Representa el modo de la mayoría del uso de recursos y la menor latencia en un estado De ejecución, sin estar realmente en un estado de KSSTATE_RUN . Los datos se pueden almacenar en búfer en este estado. Si se consulta el estado del pin y ese estado está actualmente en pausa, el pin puede devolver un error de STATUS_NO_DATA_DETECTED para indicar que este pin no realiza la puesta en cola de datos cuando está en un estado en pausa.
KSSTATE_RUN	El pin es datos de streaming. Es decir, el pin consume o genera datos de flujo.

Valor devuelto

Devuelve NOERROR si se ejecuta correctamente; de lo contrario, devuelve un código de error.

Comentarios

El estado de la patilla proporciona un control de motor bruto para las patillas. El control de motor fino se realiza de forma de clase por clase con propiedades personalizadas. Por ejemplo, para poner en marcha un reproductor de disco láser externo, podría establecer una propiedad mode personalizada específica de esa clase. Establecer esta propiedad también puede cambiar el estado del dispositivo, aunque no necesariamente, en función del efecto del modo.

Un filtro puede admitir esta propiedad de estado para que las aplicaciones puedan establecer el estado del filtro completo. De lo contrario, cada patilla debe tener su estado establecido. Cuando el estado de una patilla pasa de KSSTATE_STOP, cada conexión que reenvía los IRP debe recalcular la profundidad de la pila.

El proxy usa la propiedad KSPROPERTY_CLOCK_STATE para recuperar el estado de streaming de un pin.

Requisitos

Requisito	Value
Plataforma de destino	Escritorio
Encabezado	ksproxy.h (incluya Ksproxy.h)