Função KsPinGetAvailableByteCount (ks.h)
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 de 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.
Valor de retorno
Retorna STATUS_SUCCESS se as contagens solicitadas tiverem sido recuperadas. Um status de retorno malsucedido indica que Pin não tem uma fila associada.
Observações
Os pinos noninplace devem usar InputDataBytes para pinos de entrada e OutputBufferBytes para pinos de saída.
Os resultados dessa chamada não são garantidos como seguros, a menos que o mutex de processamento seja mantido no momento da chamada ou o chamador tenha 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 fluxo de borda à esquerda e à direita.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Microsoft Windows XP e em sistemas operacionais posteriores e no DirectX 8.0 e versões posteriores do DirectX. |
| da Plataforma de Destino | Universal |
| cabeçalho | ks.h (incluir Ks.h) |
| biblioteca | Ks.lib |
Consulte também
KsFilterAcquireProcessingMutex
KsFilterReleaseProcessingMutex
KsPinGetLeadingEdgeStreamPointer