KsHandleSizedListQuery-Funktion (ks.h)

Artikel
02/07/2025

Die KsHandleSizedListQuery--Funktion gibt abhängig von der Länge des Systempuffers entweder die Größe des benötigten Puffers, die Anzahl der Einträge in der angegebenen Datenliste zurück oder kopiert die Einträge selbst. Dabei wird davon ausgegangen, dass die Struktur von KSMULTIPLE_ITEM eine Größe gefolgt von einer Anzahl sein soll.

Syntax

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

Parameter

[in] Irp

Gibt das IRP mit der Id-Listenanforderung an.

[in] DataItemsCount

Gibt die Anzahl der Elemente in der Bezeichnerliste an.

[in] DataItemSize

Gibt die Größe eines Datenelements an.

[in] DataItems

Gibt die Liste der Datenelemente an.

Rückgabewert

Die KsHandleSizedListQuery--Funktion gibt STATUS_SUCCESS zurück, wenn die Anzahl der Einträge und die Daten kopiert werden können. Wenn der Puffer größer als die Größe ist, die nur die Größe und die Anzahl der Einträge, aber zu klein ist, um alle Einträge zu enthalten, gibt die Funktion den Status STATUS_BUFFER_TOO_SMALL zurück.

Bemerkungen

Verwenden Sie die funktion KsHandleSizedListQuery bei der Implementierung von Eigenschaften, die Informationen im Mehrelementformat zurückgeben sollen.

Anforderungen

Anforderung	Wert
Zielplattform-	Universal
Header-	ks.h (enthalten Ks.h)
Library	Ks.lib

Freigeben über