KsHandleSizedListQuery, fonction (ks.h)

Article
02/07/2025

La fonction KsHandleSizedListQuery, en fonction de la longueur de la mémoire tampon système, retourne la taille de la mémoire tampon nécessaire, le nombre d’entrées dans la liste de données spécifiée ou copie les entrées elles-mêmes. Cela suppose que la structure de KSMULTIPLE_ITEM est une taille suivie d’un nombre.

Syntaxe

KSDDKAPI NTSTATUS KsHandleSizedListQuery(
  [in] PIRP       Irp,
  [in] ULONG      DataItemsCount,
  [in] ULONG      DataItemSize,
  [in] const VOID *DataItems
);

Paramètres

[in] Irp

Spécifie l’IRP avec la demande de liste d’identificateurs.

[in] DataItemsCount

Spécifie le nombre d’éléments dans la liste d’identificateurs.

[in] DataItemSize

Spécifie la taille d’un élément de données.

[in] DataItems

Spécifie la liste des éléments de données.

Valeur de retour

La fonction KsHandleSizedListQuery retourne STATUS_SUCCESS si le nombre d’entrées et les données peuvent être copiées. Si la mémoire tampon est supérieure à la taille pour stocker uniquement la taille et le nombre d’entrées, mais trop petite pour contenir toutes les entrées, la fonction retourne l’état STATUS_BUFFER_TOO_SMALL.

Remarques

Utilisez la fonction KsHandleSizedListQuery lors de l’implémentation de propriétés qui doivent retourner des informations au format de plusieurs éléments.

Exigences

Exigence	Valeur
plateforme cible	Universel
d’en-tête	ks.h (include Ks.h)
bibliothèque	Ks.lib

Partager via