Função KsStreamPointerAdvanceOffsets (ks.h)
A função KsStreamPointerAdvanceOffsets avança os deslocamentos de do StreamPointer.
Sintaxe
KSDDKAPI NTSTATUS KsStreamPointerAdvanceOffsets(
[in] PKSSTREAM_POINTER StreamPointer,
[in] ULONG InUsed,
[in] ULONG OutUsed,
[in] BOOLEAN Eject
);
Parâmetros
[in] StreamPointer
Um ponteiro para uma estrutura KSSTREAM_POINTER que representa o ponteiro de fluxo para o qual avançar os deslocamentos. do StreamPointer deve estar no estado bloqueado quando essa função for chamada.
[in] InUsed
O número de bytes para avançar o ponteiro de entrada desse ponteiro de fluxo.
(StreamPointer –> OffsetIn)
[in] OutUsed
O número de bytes para avançar o ponteiro de saída deste ponteiro de fluxo
(StreamPointer –> OffsetOut)
[in] Eject
Esse parâmetro indica se o ponteiro de fluxo deve ser avançado para o próximo quadro de dados Se esse parâmetro estiver definido como TRUE, o AVStream avançará o ponteiro do fluxo independentemente de o avanço dos deslocamentos fazer com que o ponteiro de fluxo aponte para o final de um quadro.
Valor de retorno
KsStreamPointerAdvanceOffsets retorna STATUS_SUCCESS com êxito. Retornará STATUS_DEVICE_NOT_READY se do StreamPointer não estiver bloqueado no momento da chamada ou se o ponteiro do fluxo não puder ser bloqueado após o avanço.
Observações
O AVStream atualiza os ponteiros de dados de entrada e saída e outros campos relacionados pelos valores solicitados. Se o avanço dos deslocamentos resultar em zero bytes restantes no quadro atual, o AVStream avançará o ponteiro de fluxo para o próximo quadro de dados e o cadeia novamente.
É responsabilidade do minidriver verificar se do StreamPointer está bloqueado antes de chamar KsStreamPointerAdvanceOffsets. Além disso, um único avanço não pode avançar um ponteiro de fluxo além do início do próximo quadro na fila. Portanto, os minidrivers não devem tentar avançar deslocamentos por um valor maior que StreamPointer –> Deslocamento*. Restante.
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 |