KsHandleSizedListQuery-Funktion (ks.h)

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 oder die Einträge selbst zurück. Dabei wird davon ausgegangen, dass die Struktur von KSMULTIPLE_ITEM eine Größe gefolgt von einer Anzahl ist.

Syntax

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

Parameter

[in] Irp

Gibt die IRP mit der IdNR-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, um nur die Größe und die Anzahl der Einträge zu speichern, aber zu klein ist, um alle Einträge zu enthalten, gibt die Funktion status STATUS_BUFFER_TOO_SMALL zurück.

Hinweise

Verwenden Sie die KsHandleSizedListQuery-Funktion , wenn Sie Eigenschaften implementieren, die Informationen im Format mit mehreren Elementen zurückgeben sollen.

Anforderungen