Método IMiniportWaveRTOutputStream::GetPacketCount (portcls.h)

GetPacketCount retorna a contagem (baseada em 1) de pacotes completamente transferidos do buffer WaveRT para hardware.

Sintaxe

NTSTATUS GetPacketCount(
  [out] ULONG *pPacketCount
);

Parâmetros

[out] pPacketCount

pPacketCount retorna o número de pacotes completamente transferidos do buffer WaveRT para o hardware.

Retornar valor

GetPacketCount retornará STATUS_SUCCESS se a chamada tiver sido bem-sucedida. Caso contrário, a função retornará um erro apropriado status código.

Comentários

Na contagem de pacotes, o sistema operacional pode derivar a posição de fluxo dos pacotes que grava no buffer WaveRT. O sistema operacional também pode derivar a posição do buffer WaveRT do próximo pacote a ser gravado no buffer WaveRT. Para drivers WaveRT, o driver sinaliza um único evento de notificação à medida que transfere dados de cada pacote do buffer WaveRT. Portanto, o evento sozinho não pode indicar qual pacote dentro do buffer WaveRT está sendo transferido. Na operação normal, isso não é uma preocupação, mas em casos de subfluxo, a correção é obtida com mais facilidade consultando a contagem de pacotes da qual o sistema operacional pode determinar qual pacote gravar em seguida.

O PacketCount retornado indica a contagem (baseada em 1) de pacotes completamente transferidos do buffer WaveRT para o hardware. Com isso, o sistema operacional pode determinar o número baseado em 0 do pacote que está sendo transferido no momento e garantir que ele seja gravado antes desse pacote. Por exemplo, se a contagem de pacotes for 5, cinco pacotes serão completamente transferidos. Ou seja, os pacotes 0-4 foram completamente transferidos. Portanto, o pacote 5 está em andamento e o sistema operacional deve gravar o pacote 6. Se a contagem de notificações para o buffer WaveRT for 2, o pacote 6 estará no deslocamento 0 dentro do buffer WaveRT (porque 6 módulo 2 é 0 e 0 vezes o tamanho do pacote é 0).

O sistema operacional pode obter essa propriedade a qualquer momento. No entanto, geralmente, ele obtém essa propriedade apenas periodicamente ou depois que o driver retorna um erro de fluxo de dados (STATUS_DATA_LATE_ERROR, STATUS_DATA_OVERRUN) de SetWritePacket() para ressincronizar com o driver.

O driver deve redefinir a contagem de pacotes para 0 quando o fluxo estiver em KSSTATE_STOP.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível em Windows 10 e posterior.
Plataforma de Destino	Windows
Cabeçalho	portcls.h
IRQL	Nível passivo

Confira também

IMiniportWaveRTOutputStream