KSQUERYBUFFER-Struktur (ks.h)
Die KSQUERYBUFFER-Struktur wird beim Abfragen nach ausstehenden Puffern verwendet, die für ein Ereignis mit KSEVENT_TYPE_QUERYBUFFER verfügbar sind.
Syntax
typedef struct {
KSEVENT Event;
PKSEVENTDATA EventData;
PVOID Reserved;
} KSQUERYBUFFER, *PKSQUERYBUFFER;
Member
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 zur Ereignisaktivierzeit für AVStrMiniAddEvent bereitgestellt wird. Dieser Zeiger wird als eindeutiger Bezeichner für die Suche nach dem Ereignis verwendet, genau wie er beim Deaktivieren des Ereignisses verwendet wird.
Reserved
Nicht verwendet, und legen Sie auf Null fest.
Hinweise
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 angegeben, und ein beliebiger Puffer wird als zweiter Parameter für die Abfrage bereitgestellt.
Die erforderliche Pufferlänge kann abgefragt werden, indem ein Ausgabepuffer der Länge null bereitgestellt wird. Die Größe des Puffers wird im Parameter BytesReturned zurückgegeben, wobei eine Warnung status STATUS_BUFFER_OVERFLOW.
Alternativ gibt die Abfrage einen der folgenden status Werte zurück:
| Rückgabewert | BESCHREIBUNG |
|---|---|
| STATUS_NOT_FOUND | Ereignis wurde nicht gefunden |
| STATUS_INVALID_PARAMETER | es wurde nicht gepuffert. |
| STATUS_NO_MORE_ENTRIES | Keine Puffer verfügbar |
| STATUS_BUFFER_TOO_SMALL | Die Puffergröße war nicht ausreichend. |
| STATUS_SUCCESS | Das Leben ist gut. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | ks.h (einschließlich Ks.h) |