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
이 특정 기본 개체 클래스에 대한 디스패치 만들기 함수를 포함합니다. 이 함수 형식의 서명은 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.OverlayDriverContext 멤버에 배치됩니다. KSCREATE_ITEM_IRP_STORAGE 매크로를 사용하여 이 포인터에 액세스할 수 있습니다. 이 매크로 및 관련 매크로는 ks.h포함되어 있습니다.
미니 드라이버는 컨텍스트 필드를 검사하는 새 개체를 만들 때 이 포인터를 검색할 수 있습니다.
요구 사항
| 요구 | 값 |
|---|---|
| 헤더 | ks.h(Ks.h 포함) |