Função KsStreamPointerAdvance (ks.h)

Artigo
03/01/2024

A função KsStreamPointerAdvance avança um ponteiro de fluxo para o próximo quadro de dados.

Sintaxe

KSDDKAPI NTSTATUS KsStreamPointerAdvance(
  [in] PKSSTREAM_POINTER StreamPointer
);

Parâmetros

[in] StreamPointer

Um ponteiro para uma estrutura KSSTREAM_POINTER que representa o ponteiro de fluxo para avançar para fazer referência ao próximo quadro de dados disponível.

Retornar valor

KsStreamPointerAdvance retorna STATUS_SUCCESS para indicar um avanço bem-sucedido. Ele retorna um código de erro caso contrário. STATUS_DEVICE_NOT_READY é o código de erro retornado com mais frequência e geralmente indica que o bloqueio do ponteiro de fluxo após o avanço falhou. Em outras palavras, o StreamPointer faz referência ao último quadro na fila.

Comentários

Se o StreamPointer estiver bloqueado no momento da chamada, o AVStream o desbloqueará antes de avançar. Uma vez avançado, o ponteiro de fluxo é colocado novamente em seu estado original (bloqueado ou desbloqueado) no novo quadro.

Uma tentativa de avançar um ponteiro de fluxo desbloqueado sempre é bem-sucedida e retorna STATUS_SUCCESS. Como o ponteiro de fluxo não está bloqueado, não há como determinar se o ponteiro de fluxo faz referência aos dados reais. O minidriver deve tentar um bloqueio para determinar se o ponteiro de fluxo recém-avançado faz referência a um quadro de dados ou não.

Consulte também Stream Ponteiros.

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
IRQL	<=DISPATCH_LEVEL