Metodo IKsClockPropertySet::KsGetState (ksproxy.h)

Il metodo KsGetState recupera lo stato di streaming di un pin dall'orologio sottostante.

Sintassi

HRESULT KsGetState(
  [out] KSSTATE *State
);

Parametri

[out] State

Puntatore a una variabile che riceve un valore che specifica lo stato di streaming di un pin. Questo valore può essere uno dei valori seguenti del tipo enumerato KSSTATE:

Valore	Descrizione
KSSTATE_STOP	Lo streaming di dati da o verso il pin viene arrestato. Rappresenta lo stato iniziale del pin con il minor utilizzo delle risorse e la latenza maggiore per ottenere uno stato KSSTATE_RUN.
KSSTATE_ACQUIRE	Rappresenta lo stato in cui vengono negoziati gli allocatori e le risorse acquisite, anche se in questo stato non è possibile memorizzare dati nel buffer.
KSSTATE_PAUSE	L'orologio è in attesa ed è pronto a cambiare immediatamente lo stato di KSSTATE_RUN. Rappresenta la modalità di utilizzo della maggior parte delle risorse e la latenza minima a uno stato Run, senza essere effettivamente in uno stato KSSTATE_RUN. I dati possono essere memorizzati nel buffer in questo stato. Se viene eseguita una query sullo stato del pin e lo stato è attualmente sospeso, il pin può restituire un errore di STATUS_NO_DATA_DETECTED per indicare che questo pin non esegue l'accodamento dei dati in uno stato sospeso.
KSSTATE_RUN	Il pin è un flusso di dati. Ovvero, il pin utilizza o produce dati di flusso.

Valore restituito

Restituisce NOERROR se ha esito positivo; in caso contrario, restituisce un codice di errore.

Osservazioni

Lo stato del pin fornisce il controllo motore lordo per i pin. Il controllo motore fine viene eseguito su base classe per classe con proprietà personalizzate. Ad esempio, per creare un lettore di dischi laser esterno, è possibile impostare una proprietà Mode personalizzata specifica per tale classe. L'impostazione di questa proprietà può anche modificare lo stato del dispositivo, anche se non necessariamente, a seconda dell'effetto della modalità.

Un filtro può supportare questa proprietà di stato in modo che le applicazioni possano impostare lo stato dell'intero filtro. In caso contrario, ogni pin deve avere il relativo stato impostato. Quando lo stato di un pin passa da KSSTATE_STOP, ogni connessione che inoltra i runtime di integrazione deve ricalcolare la profondità dello stack.

Il proxy usa la proprietà KSPROPERTY_CLOCK_STATE per recuperare lo stato di streaming di un pin.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	ksproxy.h (include Ksproxy.h)