KsAllocateObjectCreateItem 함수(ks.h)

KsAllocateObjectCreateItem 함수는 지정된 만들기 항목에 슬롯을 할당하고 필요에 따라 에 공간을 할당하고 만들기 항목 데이터도 복사합니다. 이 함수는 호출자가 만들기 항목 목록에 대한 여러 변경 내용을 직렬화한다고 가정합니다.

구문

KSDDKAPI NTSTATUS KsAllocateObjectCreateItem(
  [in]           KSDEVICE_HEADER       Header,
  [in]           PKSOBJECT_CREATE_ITEM CreateItem,
  [in]           BOOLEAN               AllocateEntry,
  [in, optional] PFNKSITEMFREECALLBACK ItemFreeCallback
);

매개 변수

[in] Header

만들기 항목을 연결할 디바이스 헤더를 가리킵니다.

[in] CreateItem

연결할 만들기 항목을 포함합니다.

[in] AllocateEntry

전달된 항목 만들기 포인터를 헤더에 직접 연결해야 하는지 또는 복사본을 대신 만들어야 하는지 여부를 나타냅니다.

[in, optional] ItemFreeCallback

필요에 따라 디바이스 헤더를 해제할 때 만들기 항목이 제거될 때 호출할 미니드라이버 정의 KStrItemFreeCallback 함수에 대한 포인터를 포함합니다. AllocateEntry가 TRUE인 경우에만 유효합니다.

반환 값

새 항목이 할당되고 연결된 경우 STATUS_SUCCESS 반환합니다. 그렇지 않으면 STATUS_INSUFFICIENT_RESOURCES 반환합니다.

요구 사항

요구 사항	값
대상 플랫폼	유니버설
헤더	ks.h(Ks.h 포함)
라이브러리	Ks.lib

추가 정보

KStrItemFreeCallback