Função KsStreamPointerAdvance (ks.h)
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 |