KSPROPERTY_RTAUDIO_SETWRITEPACKET
KSPROPERTY_RTAUDIO_SETWRITEPACKET informa ao driver que o sistema operacional gravou dados válidos no buffer WaveRT.
Tabela de Resumo de Uso
Obter | Definir | Destino | Tipo de descritor de propriedade | Tipo de valor da propriedade |
---|---|---|---|---|
Não | Sim | Pin | KSPROPERTY | KSRTAUDIO_SETWRITEPACKET_INFO |
O descritor de propriedade (dados da instância) é uma estrutura KSPROPERTY . Antes de enviar a solicitação, o cliente carrega a estrutura com valores que incluem o número do pacote, o comprimento do pacote e outras informações.
O valor da propriedade é uma estrutura do tipo KSRTAUDIO_SETWRITEPACKET_INFO.
Valor retornado
Uma solicitação de propriedade KSPROPERTY_RTAUDIO_SETWRITEPACKET retorna STATUS_SUCCESS para indicar que foi concluída com êxito. Caso contrário, a solicitação retornará uma falha apropriada status código.
Comentários
Se esse KSPROPERTY tiver suporte, o driver poderá, opcionalmente, usar as informações fornecidas para otimizar a transferência de hardware. Por exemplo, o driver pode otimizar as transferências de DMA ou o hardware do programa para interromper a transferência no final do pacote especificado caso o sistema operacional não chame essa rotina novamente para informar o driver de outro pacote. Isso pode atenuar os efeitos audíveis do fluxo inferior, por exemplo, introduzindo uma lacuna audível em vez de repetir um buffer circular. No entanto, o driver ainda é obrigado a aumentar seu contador de pacotes interno e sinalizar eventos de notificação a uma taxa nominal em tempo real.
Exceto quando o sistema operacional especifica o sinalizador KSSTREAM_HEADER_OPTIONSF_ENDOFSTREAM , o tamanho do pacote é o tamanho do buffer WaveRT dividido pelo NotificationCount passado para KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION.
Dependendo dos recursos de hardware, se o sinalizador KSSTREAM_HEADER_OPTIONSF_ENDOFSTREAM for especificado, o driver poderá silenciar o preenchimento de uma parte do buffer WaveRT que segue o pacote EOS caso o hardware transfira dados além da posição do EOS.
Requisitos
Versão |
Disponível em sistemas operacionais Windows Windows 10 e posteriores. |
Cabeçalho |
Ksmedia.h |