Funzione KsPinGetAvailableByteCount (ks.h)

Articolo
05/23/2024

La routine KsPinGetAvailableByteCount restituisce il numero di byte di dati di input prima del bordo principale e il numero di byte del buffer di output davanti al bordo principale, 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 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 prima del bordo principale. 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 principale. Il chiamante imposta su NULL se questo valore non è richiesto.

Valore restituito

Restituisce STATUS_SUCCESS se sono stati recuperati i conteggi richiesti. Lo stato restituito non riuscito indica che Il pin non ha una coda associata.

Commenti

I pin nonplace 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 abbia sincronizzato privatamente prima di chiamare la routine. Per la sincronizzazione privata, assicurarsi che il pin non passi da Acquisisci a Arresta durante l'esecuzione della routine. Vedere Elaborazione mutex in AVStream.

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

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

Per altre informazioni, vedere Puntatori Stream perimetrali iniziali e finali.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Microsoft Windows XP e versioni successive e DirectX 8.0 e versioni successive di DirectX.
Piattaforma di destinazione	Universale
Intestazione	ks.h (include Ks.h)
Libreria	Ks.lib