KsHandleSizedListQuery, fonction (ks.h)

Article
02/26/2024

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 être 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 retournée

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 à stocker uniquement la taille et le nombre d’entrées, mais trop petite pour contenir toutes les entrées, la fonction retourne status STATUS_BUFFER_TOO_SMALL.

Remarques

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

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
En-tête	ks.h (inclure Ks.h)
Bibliothèque	Ks.lib

Partager via