Функция PcwUnregister (wdm.h)

Статья
03/08/2023

Функция PcwUnregister закрывает регистрацию указанного набора счетчиков. Большинство разработчиков будут использовать функцию UnregisterXxx, созданную CTRPP, вместо того чтобы вызывать эту функцию напрямую.

Синтаксис

void PcwUnregister(
  PPCW_REGISTRATION Registration
);

Параметры

Registration

[в указателе на закрываемую регистрацию.

Возвращаемое значение

None

Remarks

Функция PcwUnregister закрывает регистрацию указанного набора счетчиков. Экземпляры, принадлежащие регистрации набора счетчиков, автоматически закрываются. Поставщик не должен обращаться к этим экземплярам во время отмены регистрации набора счетчиков или после отмены регистрации набора счетчиков.

Прежде чем поставщик использует эту функцию, поставщик должен вызвать функцию PcwRegister для создания регистрации.

Функция UnregisterXxx, созданная CTRPP

Большинству разработчиков не нужно вызывать PcwUnregister напрямую. Вместо этого они компилируют манифест с помощью средства CTRPP и используют функцию UnregisterXxx из заголовка, созданного CTRPP. Созданная функция будет выглядеть следующим образом:

EXTERN_C FORCEINLINE VOID
UnregisterMyCounterset(
    VOID
    )
{
    PAGED_CODE();

    PcwUnregister(MyCounterset);
}

Функция Unregister, созданная CTRPP, будет называться PrefixUnregisterCounterSet. Префикс обычно пуст, но может присутствовать, если -prefix параметр использовался в командной строке CTRPP. CounterSet — это имя набора счетчиков, как указано в манифесте. Обратите внимание, что функция ссылается на переменную Counterset (MyCounterset в примере), которая является глобальной переменной, содержащей дескриптор регистрации набора счетчиков, инициализированный функцией RegisterXxx, созданной CTRPP.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows 7 и более поздних версиях Windows.
Целевая платформа	Универсальное
Верхняя часть	wdm.h (включая Wdm.h, Ntddk.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	IRQL <= APC_LEVEL

См. также раздел

Функция PcwRegister

Поделиться через