KsAllocateObjectBag 함수(ks.h)
KsAllocateObjectBag 함수는 개체 모음을 만들고 KSDEVICE와 연결합니다.
구문
KSDDKAPI NTSTATUS KsAllocateObjectBag(
[in] PKSDEVICE Device,
[out] KSOBJECT_BAG *ObjectBag
);
매개 변수
[in] Device
새로 만든 개체 모음과 연결된 디바이스 개체를 나타내는 KSDEVICE 에 대한 포인터입니다.
[out] ObjectBag
새로 할당된 개체 모음이 보관되는 KSOBJECT_BAG(KSOBJECT_BAG 구조체는 PVOID 형식과 동일)에 대한 포인터입니다.
반환 값
새 개체 모음이 만들어지면 STATUS_SUCCESS 반환합니다. 새 개체 모음이 할당되지 않은 경우 STATUS_INSUFFICIENT_RESOURCES 반환합니다.
설명
할당된 개체 모음은 자동으로 삭제되지 않습니다. KsAllocateObjectBag을 호출하는 미니드라이버가 개체 모음을 삭제합니다. 이 작업을 수행하는 가장 쉬운 방법은 KsFreeObjectBag을 호출하는 것입니다. 또는 미니드라이버에 가방에 있는 항목의 주소가 있는 경우 미니 드라이버는 KsRemoveItemFromObjectBag을 호출하여 개별적으로 삭제할 수 있습니다.
자세한 내용은 개체 모음을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Microsoft Windows XP 이상 운영 체제 및 DirectX 8.0 이상 DirectX 버전에서 사용할 수 있습니다. |
| 대상 플랫폼 | 유니버설 |
| 헤더 | ks.h(Ks.h 포함) |
| 라이브러리 | Ks.lib |
| IRQL | PASSIVE_LEVEL |