AcxRtStreamNotifyPacketComplete-Funktion (acxstreams.h)

Der Treiber ruft AcxRtStreamNotifyPacketComplete- auf, wenn ein Paket abgeschlossen wurde. Die Paketabschlusszeit und der 0-basierte Paketindex sind enthalten, um die Clientleistung zu verbessern. Das ACX-Framework legt alle dem Datenstrom zugeordneten Benachrichtigungsereignisse fest.

Syntax

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

Parameter

Stream

Ein vorhandenes ACXSTREAM-Objekt. Ein ACXSTREAM -Objekt stellt einen Von einem Schaltkreis erstellten Audiodatenstrom dar. Der Datenstrom besteht aus einer Liste von Elementen, die basierend auf den Elementen des übergeordneten Schaltkreises erstellt wurden.

CompletedPacket

Ein 0-basierter Paketindex, der das soeben abgeschlossene Paket angibt.

QPCCompletion

Die Paketabschlusszeit, wie von KeQueryPerformanceCounterzurückgegeben. Dieser Wert sollte so nah wie möglich am tatsächlichen Hardwareabschluss liegen (z. B. kann der Treiber KeQueryPerformanceCounter in seiner Interrupt Service Routine aufrufen).

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn der Anruf erfolgreich war. Andernfalls wird ein entsprechender Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Verwenden von NTSTATUS-Werten.

Bemerkungen

AcxRtStreamNotifyPacketComplete muss bei DISPATCH_LEVEL oder darunter aufgerufen werden.

Beispiel

Die Beispielverwendung wird unten gezeigt.

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);

ACX-Anforderungen

Mindestens ACX-Version: 1.0

Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.

Anforderungen

Siehe auch

• acxstreams.h-Header-