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)

Consulte también

KSBUFFER_ITEM

KSEVENT