Funzione KsPinGetAvailableByteCount (ks.h)

Articolo
02/07/2025

La routine KsPinGetAvailableByteCount restituisce il numero di byte di dati di input davanti al bordo iniziale e il numero di byte del buffer di output davanti al bordo iniziale, entrambi per la coda di un pin specificato dal chiamante.

Sintassi

KSDDKAPI NTSTATUS KsPinGetAvailableByteCount(
  [in]            PKSPIN Pin,
  [out, optional] PLONG  InputDataBytes,
  [out, optional] PLONG  OutputBufferBytes
);

Parametri

[in] Pin

Puntatore a una struttura di KSPIN per cui calcolare questi parametri della coda.

[out, optional] InputDataBytes

Puntatore a un valore LONG in cui la routine restituisce il numero di byte di dati di input davanti al bordo iniziale. Il chiamante imposta su NULL se questo valore non è richiesto.

[out, optional] OutputBufferBytes

Puntatore a un valore LONG in cui la routine restituisce il numero di byte del buffer di output davanti al bordo iniziale. Il chiamante imposta su NULL se questo valore non è richiesto.

Valore restituito

Restituisce STATUS_SUCCESS se i conteggi richiesti sono stati recuperati. Uno stato restituito non riuscito indica che Pin non dispone di una coda associata.

Osservazioni

I pin non posizionati devono usare inputDataBytes per i pin di input e OutputBufferBytes per i pin di output.

I risultati di questa chiamata non sono garantiti per essere sicuri, a meno che il mutex di elaborazione non venga mantenuto in fase di chiamata o che il chiamante sia sincronizzato privatamente prima di chiamare la routine. Per eseguire la sincronizzazione privata, assicurarsi che il pin non passi da Acquire a Stop durante l'esecuzione della routine. Vedere Processing Mutex in AVStream.

Si noti anche che la trasformazione sul posto può fornire conteggi di input e output.

In Windows XP e DirectX 8.0, il InputDataBytes conteggio non è valido a meno che i fotogrammi ricevuti dal filtro siano completi.

Per altre informazioni, vedere puntatori di flusso perimetrali iniziali e finali.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile in Microsoft Windows XP e nei sistemi operativi successivi e in DirectX 8.0 e versioni successive di DirectX.
piattaforma di destinazione	Universale
intestazione	ks.h (include Ks.h)
libreria	Ks.lib