IKsControl::KsEvent-Methode (ks.h)

Die IKsControl::KsEvent-Methode aktiviert oder deaktiviert ein Ereignis zusammen mit allen anderen definierten Supportvorgängen, die für eine Ereignismenge verfügbar sind.

Syntax

NTSTATUS KsEvent(
  PKSEVENT Event,
  ULONG    EventLength,
  PVOID    EventData,
  ULONG    DataLength,
  ULONG    *BytesReturned
);

Parameter

Event

Zeiger auf eine KSEVENT-Struktur , die ein Ereignis beschreibt, um das Ereignis zu aktivieren, und NULL , um das Ereignis zu deaktivieren.

EventLength

Gibt die Größe des Puffers in Bytes bei Ereignis an, wenn das Ereignis aktiviert ist, und null, wenn das Ereignis deaktiviert ist.

EventData

Zeiger auf eine KSEVENTDATA-Struktur , die Daten für das Ereignis und den Pufferbereich enthält, der Daten für das Ereignis empfängt.

DataLength

Gibt die Größe des Puffers bei EventData in Bytes an.

BytesReturned

Zeiger auf eine Variable, die die Größe der Daten in Bytes empfängt, die KsEvent im Puffer unter EventData speichert.

Rückgabewert

Die IKsControl::KsEvent-Methode gibt denselben Wert zurück, der zurückgegeben würde, wenn das Ereignis von IOCTL gesendet worden wäre.

Hinweise

Um ein Ereignis zu deaktivieren, legen Sie Event auf NULL, EventLength auf 0 und EventData auf den Zeiger auf die KSEVENTDATA-Struktur fest, die zuvor zum Aktivieren des Ereignisses verwendet wurde.

Anforderungen

Weitere Informationen

KSEVENT

KSEVENTDATA