Share via

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

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

InstanceId

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

CollectMultiple

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

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

Buffer

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

CancelEvent

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

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 7 및 이후 버전의 Windows에서 사용할 수 있습니다.
머리글 wdm.h(Wdm.h, Ntddk.h 포함)

추가 정보

PCW_CALLBACK 콜백 함수

_PCW_CALLBACK_INFORMATION 구조체