PCW_MASK_INFORMATION 구조체(wdm.h)

구조체 PCW_MASK_INFORMATION 는 _PCW_CALLBACK_INFORMATION 공용 구조체의 형식 EnumerateInstances 및 CollectData 멤버입니다. 시스템에서 공급자 정의 PCW_CALLBACK 함수로 보낸 알림의 세부 정보를 포함합니다.

구문

typedef struct _PCW_MASK_INFORMATION {
  ULONG64          CounterMask;
  PCUNICODE_STRING InstanceMask;
  ULONG            InstanceId;
  BOOLEAN          CollectMultiple;
  PPCW_BUFFER      Buffer;
  PKEVENT          CancelEvent;
} PCW_MASK_INFORMATION, *PPCW_MASK_INFORMATION;

구성원

CounterMask

비트 마스크입니다. x-th 비트가 설정된 경우 ID x 가 있는 카운터가 쿼리에 포함됩니다.

InstanceMask

쿼리에서 일치시킬 인스턴스 이름의 와일드카드 사양을 포함하는 유니코드 문자열입니다. 모든 인스턴스 이름이 쿼리 InstanceMask 와 일치해야 하는 경우 필드는 입니다 "*". 그렇지 않으면 "*" "?" "0자 이상" 및 "임의의 문자"의 일반적인 와일드카드 의미가 있습니다. 인스턴스 이름 일치는 대/소문자를 구분하지 않습니다.

InstanceId

수집할 인스턴스의 ID를 식별하는 숫자 값입니다. 값이 PCW_ANY_INSTANCE_ID (0xFFFFFFFF) 모든 인스턴스 ID가 쿼리와 일치해야 합니다.

CollectMultiple

소비자가 쿼리 결과에 둘 이상의 인스턴스를 허용할지 여부를 나타내는 BOOLEAN 값입니다. 카운터 세트가 단일 인스턴스 카운터 세트로 처리되는 경우 FALSE입니다. 카운터 세트가 다중 인스턴스 카운터 세트로 처리되는 경우 TRUE입니다.

이 값을 사용하여 데이터 수집을 최적화할 수 있습니다. false이면 CollectMultiple 소비자가 추가 인스턴스를 무시하기 때문에 하나의 인스턴스를 추가한 후 데이터 컬렉션 콜백이 반환될 수 있습니다.

Buffer

카운터 세트의 인스턴스가 추가될 시스템 관리 버퍼에 대한 핸들입니다. 이 핸들은 PcwAddInstance를 호출할 때 또는 PcwAddInstance 호출을 래핑하는 CTRPP 생성 AddXxx 함수를 호출할 때 사용해야 합니다. 자세한 내용은 해당 페이지의 비고를 참조하세요.

CancelEvent

이 필드가 NULL이 아닌 경우 요청이 취소되면 신호를 받을 초기화된 이벤트 개체입니다.

요구 사항

지원되는 최소 클라이언트	Windows 7 이상 버전의 Windows 사용할 수 있습니다.
헤더	wdm.h(Wdm.h, Ntddk.h 포함)

참고 항목

PCW_CALLBACK 콜백 함수

_PCW_CALLBACK_INFORMATION 구조체