AcxStreamAddEvents-Funktion (acxstreams.h)

  • Artikel

AcxStreamAddEvents fügt einem vorhandenen Stream mithilfe eines ACXEVENT-Objekts Ereignisse hinzu. Weitere Informationen zu ACX-Objekten finden Sie unter ACX – Zusammenfassung von ACX-Objekten.

Syntax

NTSTATUS AcxStreamAddEvents(
  ACXSTREAM Stream,
  ACXEVENT  *Events,
  ULONG     EventsCount
);

Parameter

Stream

Ein vorhandenes ACXSTREAM-Objekt. Ein ACXSTREAM-Objekt stellt einen audiostream dar, der von einer Verbindung erstellt wird. Der Stream besteht aus einer Liste von Elementen, die basierend auf den Elementen der übergeordneten Verbindung erstellt wurden.

Events

Ein Zeiger auf die ACXEVENT-Objekte, die dem Stream hinzugefügt werden sollen. Ein ACXEVENT-Objekt stellt eine asynchrone Benachrichtigung dar, die auf Treiberebene verfügbar ist. Ereignisse können AcxCircuits, AcxStreams, AcxElements und AcxPins hinzugefügt werden. Intern werden sie als KS-Ereignisse für obere Ebenen verfügbar gemacht. Weitere Informationen zu ACX-Objekten finden Sie unter ACX – Zusammenfassung von ACX-Objekten.

EventsCount

Eine Anzahl der Ereignisse. Dies ist eine einsbasierte Anzahl.

Rückgabewert

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

Bemerkungen

Beispiel

Das Beispiel für die Verwendung ist unten dargestellt.

    ACXEVENT event;
    ...
    AcxStreamAddEvents(Stream, &event, 1);

ACX-Anforderungen

ACX-Mindestversion: 1.0

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

Anforderungen

Anforderung Wert
Header acxstreams.h
IRQL PASSIVE_LEVEL

Weitere Informationen