função de retorno de chamada PREGISTER_NOTIFICATION_EVENT (hdaudio.h)

Artigo
02/29/2024

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