IKsControl::KsEvent-Methode (ksproxy.h)

Artikel
02/26/2024

Die KsEvent-Methode aktiviert oder deaktiviert ein Ereignis zusammen mit allen anderen definierten Supportvorgängen, die für eine Ereignismenge 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 , um das Ereignis zu deaktivieren.

[in] EventLength

Größe des Puffers in Bytes bei Ereignis , wenn das Ereignis aktiviert ist, und Null, wenn das Ereignis deaktiviert ist.

[in, out] 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.

[in] DataLength

Größe des Puffers bei EventData in Byte.

[in, out] BytesReturned

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

Rückgabewert

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

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.

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 Minitreiber KsXxxGenerateEvents oder StreamClassStreamNotification aufruft.