KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT

Artigo
06/15/2023

A propriedade KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT cancela o registro de um evento de modo de usuário da notificação de evento controlada por DMA.

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 de modo de usuário.

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

Valor retornado

Uma solicitação de propriedade KSPROPERTY_ RTAUDIO_UNREGISTER_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 alguns dos possíveis códigos de status de falha.

Código de status	Significado
STATUS_NOT_SUPPORTED	Notificações de evento não são suportadas.
STATUS_INSUFFICIENT_RESOURCES	Não é possível alocar memória para o buffer.
STATUS_DEVICE_NOT_READY	O dispositivo não está pronto.

Comentários

Essa propriedade é usada para cancelar o registro de eventos de modo de usuário da 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 KSSTATE_RUN, consulte o tópico Transições de Estado .

Depois de parar o pino e antes da etapa em que você o fecha, cada evento registrado deve ser cancelado por meio de uma chamada para KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT.