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	Se detiene el streaming de datos hacia o desde la patilla. 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 los 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á en pausa actualmente, 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.

Observaciones

El estado de la patilla proporciona control de motor bruto para las patillas. El control de motor fino se realiza 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, dependiendo del efecto del modo.

Un filtro puede admitir esta propiedad de estado para que las aplicaciones puedan establecer el estado completo del filtro. 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	Valor
de la plataforma de destino de	Escritorio
encabezado de	ksproxy.h (incluya Ksproxy.h)