Estructura KSQUERYBUFFER (ks.h)
La estructura KSQUERYBUFFER se usa al consultar los búferes pendientes disponibles en un evento con KSEVENT_TYPE_QUERYBUFFER.
Sintaxis
typedef struct {
KSEVENT Event;
PKSEVENTDATA EventData;
PVOID Reserved;
} KSQUERYBUFFER, *PKSQUERYBUFFER;
Miembros
Event
Especifica la descripción del evento original, con la marca KSEVENT_TYPE_QUERYBUFFER establecida en lugar de la marca KSEVENT_TYPE_ENABLEBUFFERED .
EventData
Puntero a una estructura KSEVENTDATA . Este es el mismo puntero proporcionado a AVStrMiniAddEvent en el momento de la habilitación del evento. Este puntero se usa como identificador único en la búsqueda del evento, tal como se usa al deshabilitar el evento.
Reserved
No se usa y se establece en cero.
Comentarios
Si KSEVENT_TYPE_ENABLEBUFFERED se usó para habilitar un evento que también almacena en búfer los datos, los datos generados por el evento se pueden consultar mediante este método. La descripción del evento que se consulta se proporciona como primer parámetro y cualquier búfer se proporciona como segundo parámetro a la consulta.
La longitud del búfer necesaria se puede consultar proporcionando un búfer de salida de longitud cero. El tamaño del búfer se devuelve en el parámetro BytesReturned , con un estado de advertencia de STATUS_BUFFER_OVERFLOW.
Como alternativa, la consulta devuelve uno de los siguientes valores de estado:
| Valor devuelto | Descripción |
|---|---|
| STATUS_NOT_FOUND | no se encontró el evento |
| STATUS_INVALID_PARAMETER | no se estaba almacenando en búfer |
| STATUS_NO_MORE_ENTRIES | no había búferes disponibles |
| STATUS_BUFFER_TOO_SMALL | el tamaño del búfer no era suficiente. |
| STATUS_SUCCESS | la vida es buena. |
Requisitos
| Requisito | Valor |
|---|---|
| Header | ks.h (incluya Ks.h) |