PCAUTOMATION_TABLE 구조체(portcls.h)

아티클
02/26/2024

PCAUTOMATION_TABLE 구조에는 속성, 메서드 및 이벤트의 미니포트 드라이버 master 테이블이 포함되어 있습니다.

구문

typedef struct {
  ULONG                 PropertyItemSize;
  ULONG                 PropertyCount;
  const PCPROPERTY_ITEM *Properties;
  ULONG                 MethodItemSize;
  ULONG                 MethodCount;
  const PCMETHOD_ITEM   *Methods;
  ULONG                 EventItemSize;
  ULONG                 EventCount;
  const PCEVENT_ITEM    *Events;
  ULONG                 Reserved;
} PCAUTOMATION_TABLE, *PPCAUTOMATION_TABLE;

멤버

PropertyItemSize

사용된 속성 구조의 크기(바이트)를 지정합니다. 이 멤버를 sizeof(PCPROPERTY_ITEM) 이상으로 설정합니다. 다음 설명 섹션을 참조하세요.

PropertyCount

속성 배열의 속성 항목 수를 지정합니다.

Properties

필터의 속성 배열에 대한 포인터입니다. PCPROPERTY_ITEM 구조체 의 배열입니다.

MethodItemSize

사용되는 메서드 구조체의 크기(바이트)를 지정합니다. 이 멤버를 sizeof(PCMETHOD_ITEM) 이상으로 설정합니다. 다음 설명 섹션을 참조하세요.

MethodCount

메서드 배열의 메서드 항목 수를 지정합니다.

Methods

필터의 메서드 배열에 대한 포인터입니다. PCMETHOD_ITEM 구조체 의 배열입니다.

EventItemSize

사용된 이벤트 구조의 크기(바이트)를 지정합니다. 이 멤버를 sizeof(PCEVENT_ITEM) 이상으로 설정합니다. 다음 설명 섹션을 참조하세요.

EventCount

이벤트 배열의 이벤트 항목 수를 지정합니다.

Events

필터의 이벤트 배열에 대한 포인터입니다. PCEVENT_ITEM 구조체 의 배열입니다.

Reserved

예약되어 있습니다. 0으로 초기화합니다.

설명

구조체의 항목 포인터는 NULL일 수 있으며, 이 경우 해당 개수는 0이어야 합니다. 길이가 0이 아닌 항목 테이블의 경우 항목 크기가 헤더 파일 portcls.h에 정의된 해당 항목 구조의 크기보다 작아서는 안 됩니다. 속성, 이벤트 또는 메서드 항목의 최소 크기는 각각 sizeof(PCPROPERTY_ITEM), sizeof(PCEVENT_ITEM) 또는 sizeof(PCMETHOD_ITEM)입니다. 항목 크기는 이보다 클 수 있습니다. 이 경우 항목 구조 다음에 미니포트 드라이버가 추가하는 프라이빗 데이터가 뒤따릅니다. 항목 크기는 8의 배수여야 합니다.

IMiniport::GetDescription 메서드는 미니포트 드라이버의 자동화 테이블을 지정하는 PCAUTOMATION_TABLE 구조를 가리키는 PCFILTER_DESCRIPTOR 구조를 출력합니다.