Funzione KsHandleSizedListQuery (ks.h)

La funzione KsHandleSizedListQuery , a seconda della lunghezza del buffer di sistema, restituisce le dimensioni del buffer necessarie, il numero di voci nell'elenco di dati specificato o copia le voci stesse. Si presuppone che la struttura di KSMULTIPLE_ITEM sia una dimensione seguita da un conteggio.

Sintassi

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

Parametri

[in] Irp

Specifica l'IRP con la richiesta di elenco di identificatori.

[in] DataItemsCount

Specifica il numero di elementi nell'elenco di identificatori.

[in] DataItemSize

Specifica le dimensioni di un elemento di dati.

[in] DataItems

Specifica l'elenco di elementi di dati.

Valore restituito

La funzione KsHandleSizedListQuery restituisce STATUS_SUCCESS se è possibile copiare il numero di voci e i dati. Se il buffer è maggiore delle dimensioni per archiviare solo le dimensioni e il numero di voci ma troppo piccolo per contenere tutte le voci, la funzione restituisce lo stato STATUS_BUFFER_TOO_SMALL.

Commenti

Usare la funzione KsHandleSizedListQuery quando si implementano proprietà che restituiscono informazioni nel formato a più elementi.

Requisiti