Compartilhar via

estrutura KSAUDIO_PACKETSIZE_CONSTRAINTS2 (ksmedia.h)

  • Artigo

A estrutura KSAUDIO_PACKETSIZE_CONSTRAINTS2 descreve as restrições de hardware físico. Ele inclui uma matriz de 0 ou mais estruturas KSAUDIO_PACKETSIZE_PROCESSINGMODE_CONSTRAINT que descrevem restrições específicas para qualquer modo de processamento de sinal. O driver define essa propriedade antes de chamar PcRegisterSubdevice ou habilitar sua interface de filtro KS para seus pinos de streaming.

Sintaxe

typedef struct _KSAUDIO_PACKETSIZE_CONSTRAINTS2 {
  ULONG                                        MinPacketPeriodInHns;
  ULONG                                        PacketSizeFileAlignment;
  ULONG                                        MaxPacketSizeInBytes;
  ULONG                                        NumProcessingModeConstraints;
  KSAUDIO_PACKETSIZE_PROCESSINGMODE_CONSTRAINT ProcessingModeConstraints[ANYSIZE_ARRAY];
} KSAUDIO_PACKETSIZE_CONSTRAINTS2;

Membros

MinPacketPeriodInHns

O período mínimo absoluto de processamento suportado pelo driver expresso em unidades HNS (cem nanossegundos). Esse valor poderá ser 0 se o driver não tiver um período de processamento mínimo específico.

PacketSizeFileAlignment

O requisito de alinhamento de tamanho de byte. Use um destes valores de alinhamento de arquivo definidos:

FILE_BYTE_ALIGNMENT

FILE_WORD_ALIGNMENT

FILE_LONG_ALIGNMENT

FILE_QUAD_ALIGNMENT

FILE_OCTA_ALIGNMENT

FILE_32_BYTE_ALIGNMENT

FILE_64_BYTE_ALIGNMENT

FILE_128_BYTE_ALIGNMENT

FILE_256_BYTE_ALIGNMENT

FILE_512_BYTE_ALIGNMENT

MaxPacketSizeInBytes

O tamanho máximo absoluto do pacote com suporte pelo driver em bytes. Isso poderá ser zero se o driver não tiver um tamanho máximo de pacote específico. Esse tamanho deve ser pelo menos grande o suficiente para dar suporte a buffer de 10 ms de qualquer formato compatível com o pino. Esse tamanho também deve ser maior ou igual às restrições MinPacketSize.

NumProcessingModeConstraints

O número de restrições adicionais para modos de processamento específicos. Esse valor pode ser 0.

ProcessingModeConstraints[ANYSIZE_ARRAY]

Uma matriz de 0 ou mais restrições de modo de processamento.

Comentários

O driver define essa estrutura de dados de comprimento variável como o valor da propriedade DEVPKEY_KsAudio_PacketSize_Constraints2 na interface PnP do filtro KS que tem os pinos de streaming com as restrições.

Para drivers WaveRT, essa estrutura de dados descreve as restrições para um pacote WaveRT. Vários pacotes WaveRT (normalmente 2) são concatenados para formar o buffer WaveRT.

O struct KSAUDIO_PACKETSIZE_CONSTRAINTS2 está disponível a partir do Windows 10, versão 1607.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10
Servidor mínimo com suporte Windows Server 2016
Cabeçalho ksmedia.h