IKsControl::KsEvent-Methode (ksproxy.h)

Artikel
02/07/2025

Die KsEvent--Methode aktiviert oder deaktiviert ein Ereignis sowie alle anderen definierten Supportvorgänge, die für einen Ereignissatz verfügbar sind.

Syntax

HRESULT KsEvent(
  [in, optional] PKSEVENT Event,
  [in]           ULONG    EventLength,
  [in, out]      LPVOID   EventData,
  [in]           ULONG    DataLength,
  [in, out]      ULONG    *BytesReturned
);

Parameter

[in, optional] Event

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

[in] EventLength

Größe des Puffers in Byte bei Event, wenn das Ereignis aktiviert und null ist, wenn das Ereignis deaktiviert ist.

[in, out] EventData

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

[in] DataLength

Größe des Puffers in Bytes bei EventData-.

[in, out] BytesReturned

Zeiger auf eine Variable, die die Größe der Daten in Byte empfängt, die KsEvent-im Puffer bei EventData-gespeichert.

Rückgabewert

Gibt NOERROR zurück, wenn dies erfolgreich ist; andernfalls wird ein Fehlercode zurückgegeben. Wenn der Aufruf erfolgreich ist, befindet sich das Ereignis in der Ereignisliste des Treibers.

Bemerkungen

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

Der EventData Parameter von IKsControl::KsEvent enthält ein Handle in EventHandle.Event. Sie können warten, bis das Handle verfügbar ist, und Benachrichtigungen erhalten, wenn der Minidriver KsXxxGenerateEvents oder StreamClassStreamNotification-aufruft.