KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT
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 |
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.
Requisitos
Versão |
Disponível no Windows Vista e em sistemas operacionais Windows posteriores. |
Cabeçalho |
Ksmedia.h |
Confira também
KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY