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