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

Статья
02/29/2024

Функция PcwCloseInstance закрывает экземпляр набора счетчиков, созданный с помощью PcwCreateInstance. Большинство разработчиков будут использовать созданную CTRPP функцию CloseXxx вместо вызова этой функции напрямую.

Синтаксис

void PcwCloseInstance(
  [in] PPCW_INSTANCE Instance
);

Параметры

[in] Instance

Указатель на закрываемого экземпляра набора счетчиков.

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

None

Remarks

Используйте функцию PcwCreateInstance для создания экземпляра набора счетчиков.

Невозможно вызвать PcwCloseInstance экземпляр, если вы уже вызвали PcwUnregister для регистрации соответствующего набора счетчиков. При отмене регистрации набора счетчиков все остальные экземпляры закрываются. Их повторное закрытие приведет к аварийному завершению работы системы.

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

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

EXTERN_C FORCEINLINE VOID
CloseMyCounterset(
    __in PPCW_INSTANCE Instance
    )
{
    PAGED_CODE();

    PcwCloseInstance(Instance);
}

Функция Close, созданная CTRPP, будет называться PrefixCloseCounterSet. Префикс обычно пуст, но может присутствовать, если -prefix параметр использовался в командной строке CTRPP. CounterSet — это имя набора счетчиков, как указано в манифесте.

Требования

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

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

Функция PcwCreateInstance

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