Функция 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.
Дополнительные сведения о методе WdfWmiProviderGetTracingHand le см. в поддержкетрассировки событий WMI. Дополнительные сведения о WMI см. в поддержке WMI в Framework-Based драйверах.
Примеры
Следующий пример кода получает дескриптор для средства ведения журнала событий трассировки WPP.
ULONGLONG tracingHandle;
tracingHandle = WdfWmiProviderGetTracingHandle(wmiProvider);
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Всеобщий |
| минимальная версия KMDF | 1.0 |
| заголовка | wdfwmi.h (include Wdf.h) |
| библиотеки | Wdf01000.sys (см. управление версиями библиотеки Платформы).) |
| IRQL | <=DISPATCH_LEVEL |
| правил соответствия DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |