KsHandleSizedListQuery 함수(ks.h)

KsHandleSizedListQuery 함수는 시스템 버퍼의 길이에 따라 필요한 버퍼 크기, 지정된 데이터 목록의 항목 수를 반환하거나 항목 자체를 복사합니다. 이렇게 하면 KSMULTIPLE_ITEM 구조가 Size 다음에 Count로 가정합니다.

구문

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

매개 변수

[in] Irp

식별자 목록 요청이 있는 IRP를 지정합니다.

[in] DataItemsCount

식별자 목록의 항목 수를 지정합니다.

[in] DataItemSize

데이터 항목의 크기를 지정합니다.

[in] DataItems

데이터 항목 목록을 지정합니다.

반환 값

KsHandleSizedListQuery 함수는 항목 수와 데이터를 복사할 수 있는 경우 STATUS_SUCCESS 반환합니다. 버퍼가 크기 및 항목 수를 저장할 크기보다 크지만 모든 항목을 포함하기에는 너무 작으면 함수는 상태 STATUS_BUFFER_TOO_SMALL 반환합니다.

설명

여러 항목 형식으로 정보를 반환하는 속성을 구현할 때 KsHandleSizedListQuery 함수를 사용합니다.

요구 사항