função de retorno de chamada PREGISTER_NOTIFICATION_EVENT (hdaudio.h)
A rotina RegisterNotificationEvent registra um evento kernel para que ele possa receber notificações de progresso do DMA.
O tipo de ponteiro de função para uma rotina RegisterNotificationEvent é definido da seguinte maneira.
Sintaxe
PREGISTER_NOTIFICATION_EVENT PregisterNotificationEvent;
NTSTATUS PregisterNotificationEvent(
[in] PVOID _context,
[in] HANDLE Handle,
[in] PKEVENT NotificationEvent
)
{...}
Parâmetros
[in] _context
Especifica o valor de contexto do membro Context da estrutura HDAUDIO_BUS_INTERFACE_V2 .
[in] Handle
Identificador que identifica o mecanismo de DMA. Esse valor de identificador foi obtido de uma chamada anterior para AllocateCaptureDmaEngine ou AllocateRenderDmaEngine.
[in] NotificationEvent
Um ponteiro para um evento kernel que deve ser notificado à medida que o DMA progride. Dependendo do parâmetro de contagem de notificações usado com AllocateDmaBufferWithNotification, o evento registrado é sinalizado uma ou duas vezes para cada vez que o DMA passa pelo buffer de áudio.
Retornar valor
RegisterNotificationEvent retornará STATUS_SUCCESS se a chamada registrar com êxito o evento. Caso contrário, a rotina retornará STATUS_INSUFFICIENT_RESOURCES para indicar que não há recursos suficientes disponíveis para concluir a operação.
Comentários
RegisterNotificationEvent registra um evento kernel com o driver do barramento de áudio HD. O driver do barramento de áudio HD mantém uma lista de eventos de notificação registrados para cada mecanismo de DMA e os sinaliza sempre que o mecanismo recebe uma interrupção do COI. Os eventos não são registrados usando UnregisterNotificationEvent.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Disponível no Windows Vista e versões posteriores do Windows. |
Plataforma de Destino | Área de Trabalho |
Cabeçalho | hdaudio.h (inclua Hdaudio.h) |
IRQL | PASSIVE_LEVEL |