Hardware Dev Center

Collapse the table of content
Expand the table of content
Expand Minimize

KsHandleSizedListQuery function

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.


NTSTATUS KsHandleSizedListQuery(
  _In_       PIRP  Irp ,
  _In_       ULONG DataItemsCount ,
  _In_       ULONG DataItemSize ,
  _In_ const VOID  *DataItems 


Irp [in]

Specifies the IRP with the identifier list request.

DataItemsCount [in]

Specifies the number of items in the identifier list.

DataItemSize [in]

Specifies the size of a data item.

DataItems [in]

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.


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


Target platform



Ks.h (include Ks.h)





Send comments about this topic to Microsoft

© 2015 Microsoft