KSQUERYBUFFER-Struktur (ks.h)
Die KSQUERYBUFFER- Struktur wird beim Abfragen nach ausstehenden Puffern verwendet, die für ein Ereignis mit KSEVENT_TYPE_QUERYBUFFERverfügbar sind.
Syntax
typedef struct {
KSEVENT Event;
PKSEVENTDATA EventData;
PVOID Reserved;
} KSQUERYBUFFER, *PKSQUERYBUFFER;
Angehörige
Event
Gibt die Beschreibung des ursprünglichen Ereignisses an, wobei das KSEVENT_TYPE_QUERYBUFFER Flag anstelle des KSEVENT_TYPE_ENABLEBUFFERED-Flags festgelegt ist.
EventData
Ein Zeiger auf eine KSEVENTDATA--Struktur. Dies ist derselbe Zeiger, der für AVStrMiniAddEvent- zur Ereignisaktivierzeit bereitgestellt wird. Dieser Zeiger wird als eindeutiger Bezeichner beim Suchen des Ereignisses verwendet, genauso wie er beim Deaktivieren des Ereignisses verwendet wird.
Reserved
Wird nicht verwendet und auf Null festgelegt.
Bemerkungen
Wenn KSEVENT_TYPE_ENABLEBUFFERED verwendet wurde, um ein Ereignis zu aktivieren, das auch Daten puffert, können die vom Ereignis erzeugten Daten mit dieser Methode abgefragt werden. Die Beschreibung des abgefragten Ereignisses wird als erster Parameter bereitgestellt, und jeder Puffer wird als zweiter Parameter für die Abfrage bereitgestellt.
Die benötigte Pufferlänge kann abgefragt werden, indem ein Ausgabepuffer der Länge Null bereitgestellt wird. Die Größe des Puffers wird im BytesReturned Parameter zurückgegeben, wobei der Warnstatus STATUS_BUFFER_OVERFLOW.
Alternativ gibt die Abfrage einen der folgenden Statuswerte zurück:
| Rückgabewert | Beschreibung |
|---|---|
| STATUS_NOT_FOUND | ereignis wurde nicht gefunden |
| STATUS_INVALID_PARAMETER | es wurde nicht gepuffert. |
| STATUS_NO_MORE_ENTRIES | Es waren keine Puffer verfügbar. |
| STATUS_BUFFER_TOO_SMALL | Die Puffergröße reichte nicht aus. |
| STATUS_SUCCESS | Das Leben ist gut. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | ks.h (enthalten Ks.h) |