Função KsPinGetAvailableByteCount (ks.h)

Artigo
03/01/2024

A rotina KsPinGetAvailableByteCount gera o número de bytes de dados de entrada à frente da borda superior e o número de bytes do buffer de saída à frente da borda superior, ambos para a fila de um pino especificado pelo chamador.

Sintaxe

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

Parâmetros

[in] Pin

Um ponteiro para uma estrutura KSPIN para a qual calcular esses parâmetros de fila.

[out, optional] InputDataBytes

Um ponteiro para um valor LONG no qual a rotina retorna o número de bytes de dados de entrada à frente da borda superior. O chamador definirá como NULL se esse valor não for solicitado.

[out, optional] OutputBufferBytes

Um ponteiro para um valor LONG no qual a rotina retorna o número de bytes de buffer de saída à frente da borda superior. O chamador definirá como NULL se esse valor não for solicitado.

Retornar valor

Retorna STATUS_SUCCESS se as contagens solicitadas tiverem sido recuperadas. Uma status de retorno malsucedida indica que Pin não tem uma fila associada.

Comentários

Os pinos Noninplace devem usar InputDataBytes para pinos de entrada e OutputBufferBytes para pinos de saída.

Não há garantia de que os resultados dessa chamada sejam seguros, a menos que o mutex de processamento seja mantido no momento da chamada ou o chamador tenha sido sincronizado privadamente antes de chamar a rotina. Para sincronizar privadamente, verifique se o pino não faz a transição de Adquirir para Parar enquanto a rotina está em execução. Consulte Processando Mutex no AVStream.

Observe também que a transformação in-loco pode fornecer contagens de entrada e saída.

No Windows XP e no DirectX 8.0, a contagem InputDataBytes não é válida, a menos que os quadros recebidos pelo filtro estejam cheios.

Para obter informações adicionais, consulte Ponteiros de Stream de borda à esquerda e à direita.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Microsoft Windows XP e em sistemas operacionais posteriores e no DirectX 8.0 e versões posteriores do DirectX.
Plataforma de Destino	Universal
Cabeçalho	ks.h (inclua Ks.h)
Biblioteca	Ks.lib