Propriedades do Pino Data-Range e Interseção

Várias solicitações de propriedade fornecem informações sobre os formatos de dados para os fluxos de áudio que um dispositivo de áudio é capaz de manipular em seus pinos de entrada e saída.

Os formatos de dados de fluxo de áudio que um pino é capaz de suportar são expressos em uma matriz KSMULTIPLE_ITEM de estruturas derivadas do KSDATARANGE. O suporte ao intervalo de dados de pinos é exposto por meio das seguintes três propriedades KSPROPSETID_Pin no filtro:

KSPROPERTY_PIN_DATARANGES Esta propriedade relata intervalos de dados que são estáticos e representam todos os formatos possíveis suportados. Normalmente, os intervalos de dados estão contidos em uma matriz estática no driver do adaptador. KSPROPERTY_PIN_CONSTRAINEDDATARANGES Esta propriedade relata intervalos de dados que são dinâmicos e representam o subconjunto de formatos suportados no momento da solicitação de propriedade. O manipulador de propriedades deve conter a lógica para decidir quais formatos o pino é capaz de suportar em tempo de execução. Por exemplo, uma implementação de hardware pode ter restrições DMA que não permitem suporte para full-duplex em determinadas combinações de formato. KSPROPERTY_PIN_DATAINTERSECTION Esta propriedade seleciona um formato de dados de uma lista de faixas de dados. A seleção é baseada em recursos dinâmicos e o formato é retirado do subconjunto de formatos que o driver pode suportar no momento da solicitação de propriedade. Para usar essa propriedade, o chamador fornece uma matriz de intervalos de dados. Começando no primeiro elemento, o manipulador de propriedades pesquisa a matriz até encontrar um intervalo de dados que ele é capaz de suportar no momento. Se for bem-sucedido, o manipulador gera um formato de dados a partir do intervalo de dados e retorna STATUS_SUCCESS. Caso contrário, o manipulador retornará STATUS_NO_MATCH. Os componentes do sistema de áudio usam as propriedades KSPROPERTY_PIN_DATARANGES e KSPROPERTY_PIN_DATAINTERSECTION. Os drivers de miniporta devem oferecer suporte a essas propriedades. O suporte para KSPROPERTY_PIN_CONSTRAINEDDATARANGES é opcional.

Para obter mais informações, consulte Formatos de dados de áudio e intervalos de dados.

Observação Os KSPROPERTY_PIN_DATARANGES e KSPROPERTY_PIN_CONSTRAINEDDATARANGES começam num endereço alinhado de 8 bytes.