KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT

Artigo
06/15/2023

A propriedade KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT registra um evento de modo de usuário para notificação de evento controlada por DMA. Os eventos devem ser registrados depois de chamar KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION com êxito.

A tabela a seguir resume os recursos dessa propriedade.

Tabela de Resumo de Uso

Obter	Definir	Destino	Tipo de descritor de propriedade	Tipo de valor da propriedade
Sim	Sim	Pin	KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY	NULL

O descritor de propriedade (dados de instância) consiste em uma estrutura KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY que contém uma estrutura KSPROPERTY junto com um identificador de evento do modo de usuário.

O valor da propriedade (dados de operação) dessa propriedade é NULL porque nenhum dado de operação é retornado.

Valor retornado

Uma solicitação de propriedade KSPROPERTY_ RTAUDIO_REGISTER_NOTIFICATION_EVENT retorna STATUS_SUCCESS para indicar que foi concluída com êxito. Caso contrário, a solicitação retornará uma falha apropriada status código. A tabela a seguir mostra algumas das possíveis falhas status códigos.

Código de status	Significado
STATUS_NOT_SUPPORTED	Notificações de evento não são suportadas.
STATUS_INSUFFICIENT_RESOURCES	A memória do buffer não pode ser alocada.
STATUS_DEVICE_NOT_READY	O dispositivo não está pronto.

Comentários

Essa propriedade é usada para registrar eventos do modo de usuário para notificação de evento controlada por DMA.

Quando o pino é colocado no estado de execução (KSSTATE_RUN) os eventos registrados são sinalizados uma ou duas vezes por ciclo do buffer de áudio cíclico, dependendo da contagem de notificações solicitada quando KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION foi chamado. Para obter mais informações sobre KSSTATERUN, consulte o tópico Transições de Estado .

Depois que você parar o pino e antes do momento em que o fechar, cada evento registrado será cancelado por meio de uma chamada para KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT.