Функция WdfWmiProviderGetTracingHandle (wdfwmi.h)

  • Статья

[Относится только к KMDF]

Метод WdfWmiProviderGetTracingHandle возвращает дескриптор в средство ведения журнала событий сеанса трассировки программного обеспечения WPP .

Синтаксис

ULONGLONG WdfWmiProviderGetTracingHandle(
  [in] WDFWMIPROVIDER WmiProvider
);

Параметры

[in] WmiProvider

Дескриптор объекта поставщика WMI, который драйвер получил, вызвав WdfWmiProviderCreate или WdfWmiInstanceGetProvider.

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

WdfWmiProviderGetTracingHandle возвращает дескриптор для средства ведения журнала трассировки событий.

Ошибка проверка возникает, если драйвер предоставляет недопустимый дескриптор объекта.

Комментарии

Если драйвер задает флаг WdfWmiProviderTracing в элементе Flags структуры WDF_WMI_PROVIDER_CONFIG объекта поставщика WMI, он может вызвать WdfWmiProviderGetTracingHandle , чтобы получить дескриптор трассировки после регистрации экземпляра поставщика. Драйвер может использовать дескриптор трассировки в качестве входных данных для процедуры WmiTraceMessage .

Дополнительные сведения о методе WdfWmiProviderGetTracingHandle см. в разделе Поддержка трассировки событий WMI. Дополнительные сведения о WMI см. в разделе Поддержка WMI в драйверах Framework-Based.

Примеры

В следующем примере кода получается дескриптор для средства ведения журнала событий сеанса трассировки WPP.

ULONGLONG tracingHandle;

tracingHandle = WdfWmiProviderGetTracingHandle(wmiProvider);

Требования

Требование Значение
Целевая платформа Универсальное
Минимальная версия KMDF 1,0
Верхняя часть wdfwmi.h (включая Wdf.h)
Библиотека Wdf01000.sys (см. раздел Управление версиями библиотеки Платформы).
IRQL <=DISPATCH_LEVEL
Правила соответствия DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

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

WDF_WMI_PROVIDER_CONFIG

WdfWmiInstanceGetProvider

WdfWmiProviderCreate