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입니다.
이 값을 사용하여 데이터 수집을 최적화할 수 있습니다.
CollectMultiple false이면 소비자가 추가 인스턴스를 무시하기 때문에 하나의 인스턴스를 추가한 후 데이터 컬렉션 콜백이 반환될 수 있습니다.
Buffer
카운터 세트의 인스턴스가 추가될 시스템 관리 버퍼에 대한 핸들입니다. 이 핸들은 PcwAddInstance 호출하거나 ctwAddInstance 호출을 래핑하는 CTRPP 생성 AddXxx 함수를 호출할 때 사용해야 합니다. 자세한 내용은 해당 페이지의 비고를 참조하세요.
CancelEvent
이 필드가 NULL이 아닌 경우 요청이 취소되면 신호를 받을 초기화된 이벤트 개체입니다.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 7 이상 버전의 Windows에서 사용할 수 있습니다. |
| 헤더 | wdm.h(Wdm.h, Ntddk.h 포함) |