Structure KSQUERYBUFFER (ks.h)
La structure KSQUERYBUFFER est utilisée lors de l’interrogation des mémoires tampons en attente disponibles sur un événement avec KSEVENT_TYPE_QUERYBUFFER.
Syntaxe
typedef struct {
KSEVENT Event;
PKSEVENTDATA EventData;
PVOID Reserved;
} KSQUERYBUFFER, *PKSQUERYBUFFER;
Membres
Event
Spécifie la description de l’événement d’origine, avec l’indicateur KSEVENT_TYPE_QUERYBUFFER défini au lieu de l’indicateur KSEVENT_TYPE_ENABLEBUFFERED .
EventData
Pointeur vers une structure KSEVENTDATA . Il s’agit du même pointeur fourni à AVStrMiniAddEvent au moment de l’activation de l’événement. Ce pointeur est utilisé comme identificateur unique pour localiser l’événement, tout comme il est utilisé lors de la désactivation de l’événement.
Reserved
Non utilisé et défini sur zéro.
Remarques
Si KSEVENT_TYPE_ENABLEBUFFERED a été utilisé pour activer un événement qui met également en mémoire tampon les données, les données produites par l’événement peuvent être interrogées à l’aide de cette méthode. La description de l’événement interrogé est fournie en tant que premier paramètre, et toute mémoire tampon est fournie en tant que deuxième paramètre de la requête.
La longueur de la mémoire tampon nécessaire peut être interrogée en fournissant une mémoire tampon de sortie de longueur nulle. La taille de la mémoire tampon est retournée dans le paramètre BytesReturned, avec un avertissement status de STATUS_BUFFER_OVERFLOW.
La requête renvoie également l’une des valeurs status suivantes :
| Valeur de retour | Description |
|---|---|
| STATUS_NOT_FOUND | événement introuvable |
| STATUS_INVALID_PARAMETER | il n’était pas mis en mémoire tampon |
| STATUS_NO_MORE_ENTRIES | aucune mémoire tampon n’était disponible |
| STATUS_BUFFER_TOO_SMALL | la taille de la mémoire tampon était insuffisante. |
| STATUS_SUCCESS | la vie est bonne. |
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | ks.h (inclure Ks.h) |