Share via

Función AcxRtStreamNotifyPacketComplete (acxstreams.h)

  • Artículo

El controlador llama a AcxRtStreamNotifyPacketComplete cuando se ha completado un paquete. El tiempo de finalización del paquete y el índice de paquetes basado en 0 se incluyen para mejorar el rendimiento del cliente. El marco de ACX establecerá los eventos de notificación asociados a la secuencia.

Sintaxis

NTSTATUS AcxRtStreamNotifyPacketComplete(
  ACXSTREAM Stream,
  ULONGLONG CompletedPacket,
  ULONGLONG QPCCompletion
);

Parámetros

Stream

Objeto ACXSTREAM existente. Un objeto ACXSTREAM representa una secuencia de audio creada por un circuito. La secuencia se compone de una lista de elementos creados en función de los elementos del circuito primario.

CompletedPacket

Índice de paquetes basado en 0 que indica el paquete que se acaba de completar.

QPCCompletion

El tiempo de finalización del paquete, tal y como lo devuelve KeQueryPerformanceCounter. Este valor debe estar lo más cerca posible de la finalización de hardware real (por ejemplo, el controlador puede llamar a KeQueryPerformanceCounter desde en su rutina de servicio de interrupción).

Valor devuelto

Devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, devuelve un código de error adecuado. Para obtener más información, vea Uso de valores NTSTATUS.

Comentarios

Se debe llamar a AcxRtStreamNotifyPacketComplete en DISPATCH_LEVEL o inferior.

Ejemplo

A continuación se muestra un ejemplo de uso.

completedPacket = (ULONG)InterlockedIncrement((LONG*)&m_CurrentPacket) - 1;

InterlockedExchange64(&m_LastPacketStart.QuadPart, m_CurrentPacketStart.QuadPart);
InterlockedExchange64(&m_CurrentPacketStart.QuadPart, QPC.QuadPart);

// Tell ACX we've completed the packet.
(void)AcxRtStreamNotifyPacketComplete(m_Stream, completedPacket, QPC.QuadPart);

Requisitos de ACX

Versión mínima de ACX: 1.0

Para obtener más información sobre las versiones de ACX, consulte Introducción a la versión de ACX.

Requisitos

Requisito Valor
Header acxstreams.h
IRQL <= DISPATCH_LEVEL

Consulte también