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 de KSSTREAM_POINTER que representa o ponteiro de fluxo para avançar para fazer referência ao próximo quadro de dados disponível.
Valor de retorno
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 bloquear o ponteiro de fluxo após a falha do avanço. Em outras palavras, StreamPointer referencia o último quadro na fila.
Observações
Se do StreamPointer estiver bloqueado em tempo de chamada, o AVStream o desbloqueará antes de avançar. Uma vez avançado, o ponteiro de fluxo é colocado de volta 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 a 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 de Ponteiros de Fluxo.
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 |
| IRQL | <=DISPATCH_LEVEL |