KsHandleSizedListQuery function (ks.h)

Artikel
02/22/2024

The KsHandleSizedListQuery function, depending on the length of the system buffer, returns either the size of the buffer needed, number of entries in the specified data list, or copies the entries themselves. This assumes the structure of KSMULTIPLE_ITEM to be a Size followed by a Count.

Syntax

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

Parameters

[in] Irp

Specifies the IRP with the identifier list request.

[in] DataItemsCount

Specifies the number of items in the identifier list.

[in] DataItemSize

Specifies the size of a data item.

[in] DataItems

Specifies the list of data items.

Return value

The KsHandleSizedListQuery function returns STATUS_SUCCESS if the number of entries and the data can be copied. If the buffer is larger than the size to store just the size and the count of entries but too small to contain all the entries, the function returns status STATUS_BUFFER_TOO_SMALL.

Remarks

Use the KsHandleSizedListQuery function when implementing properties that are to return information in the multiple item format.

Requirements

Requirement	Value
Target Platform	Universal
Header	ks.h (include Ks.h)
Library	Ks.lib

Delen via