KSOBJECT_CREATE_ITEM 구조체(ks.h)
KSOBJECT_CREATE_ITEM 구조체는 만들기 요청에 전달된 문자열을 조회하는 데 사용됩니다.
구문
typedef struct {
PDRIVER_DISPATCH Create;
PVOID Context;
UNICODE_STRING ObjectClass;
PSECURITY_DESCRIPTOR SecurityDescriptor;
ULONG Flags;
} KSOBJECT_CREATE_ITEM, *PKSOBJECT_CREATE_ITEM;
멤버
Create
이 특정 기본 개체 클래스에 대한 create dispatch 함수를 포함합니다. 이 함수 형식의 서명은 DRIVER_OBJECT 참조하세요.
Context
개체 형식별 컨텍스트 정보를 저장하는 데 사용할 수 있는 버퍼를 가리킵니다. 추가 정보는 아래 설명 섹션에 있습니다.
ObjectClass
개체 클래스를 식별하는 유니코드 문자열을 가리킵니다. 이 디바이스에서 지원하는 특정 개체 클래스에 대해 PnP에 등록하는 데 사용된 문자열입니다.
SecurityDescriptor
이 유형의 개체에 대한 SECURITY_DESCRIPTOR 대한 포인터를 포함하고, 그렇지 않으면 NULL을 포함합니다. 보안을 사용하는 경우 개체 형식을 더 이상 사용하지 않을 때 해제해야 합니다. 풀 메모리를 사용해야 하며, 바꿀 수 있으므로 공유할 수 없습니다. 수정된 경우 Flags 요소가 업데이트됩니다. 선택 사항입니다.
Flags
요청 유형을 지정합니다. 플래그는 다음 표에 나열된 값을 가질 수 있습니다.
| 플래그 | 설명 |
|---|---|
| KSCREATE_ITEM_SECURITYCHANGED | 이 개체 형식의 보안 설명자가 변경되어 유지되어야 했음을 나타냅니다. |
| KSCREATE_ITEM_WILDCARD | 이 만들기 항목은 다른 만들기 항목과 일치하지 않는 만들기 요청에 사용되는 야생 카드 나타냅니다. 만들기 항목 목록에서 와일드 카드 항목의 순서는 관련이 없습니다. 단일 와일드 카드 항목만 만들기 항목 목록에서 유효합니다. |
| KSCREATE_ITEM_NOPARAMETERS | 이 만들기 항목은 매개 변수 전달을 허용하지 않으며 매개 변수가 있는 경우 실패했음을 나타냅니다. 일반적으로 만들기 매개 변수는 만들기 처리기에 전달됩니다. 이 플래그는 와일드 카드 플래그와 함께 사용할 수 없습니다. |
설명
개체를 만들기 전에 KSOBJECT_CREATE_ITEM 구조체에 대한 포인터가 Irp-Tail.Overlay>의 DriverContext 멤버에 배치됩니다. KSCREATE_ITEM_IRP_STORAGE 매크로를 사용하여 이 포인터에 액세스할 수 있습니다. 이 매크로 및 관련 매크로는 ks.h에 포함되어 있습니다.
미니 드라이버는 컨텍스트 필드를 검사할 새 개체를 만들 때 이 포인터를 검색할 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 헤더 | ks.h(Ks.h 포함) |