Compartilhar via


KSPROPERTY_DIRECTSOUND3DLISTENER_BATCH

A propriedade KSPROPERTY_DIRECTSOUND3DLISTENER_BATCH especifica a configuração de modo de lote para um ouvinte 3D.

Tabela de Resumo de Uso

Obter Definir Destino Tipo de descritor de propriedade Tipo de valor da propriedade

Sim

Sim

Pin

KSNODEPROPERTY

BOOL

O valor da propriedade (dados de operação) é do tipo BOOL e especifica a configuração do modo de lote:

  • Quando o valor dessa propriedade for TRUE, o driver de miniporto deverá armazenar em cache todas as alterações nas propriedades do ouvinte e todas as propriedades de buffer associadas.

  • Quando o valor é FALSE, as alterações nas propriedades do ouvinte e nas propriedades do buffer entrarão em vigor imediatamente.

Valor retornado

Uma solicitação de propriedade KSPROPERTY_DIRECTSOUND3DLISTENER_BATCH retorna STATUS_SUCCESS para indicar que foi concluída com êxito. Caso contrário, a solicitação retornará um erro apropriado status código.

Comentários

Quando essa propriedade faz a transição de TRUE para FALSE , o driver de miniporto deve colocar todas as propriedades armazenadas em cache imediatamente. Se possível, todas as propriedades armazenadas em cache devem ser colocadas em vigor simultaneamente.

Para obter mais informações sobre as configurações do modo de lote para ouvintes 3D, consulte a descrição do método IDirectSound3DListener::CommitDeferredSettings na documentação do SDK do Microsoft Windows.

Requisitos

parâmetro

Ksmedia.h (inclua Ksmedia.h)

Confira também

KSNODEPROPERTY