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 포함)

추가 정보

KsAllocateDeviceHeader

KsAllocateObjectHeader

KsFilterFactoryAddCreateItem