fxwmiapi.cpp File Reference

#include "fxwmipch.hpp"

Include dependency graph for fxwmiapi.cpp:

Go to the source code of this file.

Functions
_Must_inspect_result_	__drv_maxIRQL (DISPATCH_LEVEL) NTSTATUS NTAPI WDFEXPORT(WdfWmiProviderCreate)(__in PWDF_DRIVER_GLOBALS DriverGlobals
	FxObjectHandleGetPtr (GetFxDriverGlobals(DriverGlobals), Device, FX_TYPE_DEVICE,(PVOID *) &pDevice)
	FxPointerNotNull (GetFxDriverGlobals(DriverGlobals), WmiProviderConfig)
	FxPointerNotNull (GetFxDriverGlobals(DriverGlobals), WmiProvider)
	if (pDevice->m_PkgPnp->IsPowerPolicyOwner())
	FxPointerNotNull (pFxDriverGlobals, InstanceConfig)
	if (InstanceConfig->Size !=sizeof(WDF_WMI_INSTANCE_CONFIG))
	if (InstanceConfig->Provider==NULL &&InstanceConfig->ProviderConfig==NULL)
else	if (InstanceConfig->Provider !=NULL &&InstanceConfig->ProviderConfig !=NULL)
	if (!NT_SUCCESS(status))
	if (NT_SUCCESS(status) &&InstanceConfig->Register)
	if (NT_SUCCESS(status))
	FxObjectHandleGetPtr (GetFxDriverGlobals(DriverGlobals), WmiProvider, FX_TYPE_WMI_PROVIDER,(PVOID *) &pProvider)
return pProvider	GetDevice () -> GetHandle()
return pProvider	IsEnabled (ProviderControl)
return pProvider	GetTracingHandle ()
	FxObjectHandleGetPtr (GetFxDriverGlobals(DriverGlobals), WmiInstance, FX_TYPE_WMI_INSTANCE,(PVOID *) &pInstance)
return pProvider	AddInstance (pInstance)
pProvider	RemoveInstance (pInstance)
return pInstance	GetProvider () -> GetHandle()
_Must_inspect_result_	__drv_maxIRQL (APC_LEVEL) NTSTATUS NTAPI WDFEXPORT(WdfWmiInstanceFireEvent)(__in PWDF_DRIVER_GLOBALS DriverGlobals
_Must_inspect_result_ __in WDFWMIINSTANCE __in_opt ULONG	__in_bcount_opt (EventDataSize) PVOID EventData)

Variables
_Must_inspect_result_ __in WDFDEVICE	Device
_Must_inspect_result_ __in WDFDEVICE __in PWDF_WMI_PROVIDER_CONFIG	WmiProviderConfig
_Must_inspect_result_ __in WDFDEVICE __in PWDF_WMI_PROVIDER_CONFIG __in_opt PWDF_OBJECT_ATTRIBUTES	ProviderAttributes
_Must_inspect_result_ __in WDFDEVICE __in PWDF_WMI_PROVIDER_CONFIG __in_opt PWDF_OBJECT_ATTRIBUTES __out WDFWMIPROVIDER *	WmiProvider
FxPowerPolicyOwnerSettings *	ownerSettings
FxWmiProvider *	pProvider = pInstance->GetProvider()
_Must_inspect_result_ __in WDFDEVICE __in PWDF_WMI_INSTANCE_CONFIG	InstanceConfig
_Must_inspect_result_ __in WDFDEVICE __in PWDF_WMI_INSTANCE_CONFIG __in_opt PWDF_OBJECT_ATTRIBUTES	InstanceAttributes
_Must_inspect_result_ __in WDFDEVICE __in PWDF_WMI_INSTANCE_CONFIG __in_opt PWDF_OBJECT_ATTRIBUTES __out_opt WDFWMIINSTANCE *	Instance
FxWmiInstanceExternal *	pInstance = NULL
WDFWMIINSTANCE	hInstance
NTSTATUS	status
	pFxDriverGlobals = GetFxDriverGlobals(DriverGlobals)
	else
WDFWMIPROVIDER	hProvider = NULL
__in WDFWMIPROVIDER __in WDF_WMI_PROVIDER_CONTROL	ProviderControl
_Must_inspect_result_ __in WDFWMIINSTANCE	WmiInstance
_Must_inspect_result_ __in WDFWMIINSTANCE __in_opt ULONG	EventDataSize

Function Documentation

__drv_maxIRQL() [1/2]

_Must_inspect_result_ __drv_maxIRQL

(

APC_LEVEL

)

__drv_maxIRQL() [2/2]

_Must_inspect_result_ __drv_maxIRQL

(

DISPATCH_LEVEL

)

__in_bcount_opt()

_Must_inspect_result_ __in WDFWMIINSTANCE __in_opt ULONG __in_bcount_opt

(

EventDataSize

)

Definition at line 417 of file fxwmiapi.cpp.

{
    FxWmiInstanceExternal* pInstance;
    NTSTATUS status;
 
    FxObjectHandleGetPtr(GetFxDriverGlobals(DriverGlobals),
                         WmiInstance,
                         FX_TYPE_WMI_INSTANCE,
                         (PVOID*) &pInstance);
 
    status = FxVerifierCheckIrqlLevel(pInstance->GetDriverGlobals(), APC_LEVEL);
    if (!NT_SUCCESS(status)) {
        return status;
    }
 
    return pInstance->FireEvent(EventData, EventDataSize);
}

AddInstance()

return pProvider AddInstance

(

pInstance

)

FxObjectHandleGetPtr() [1/3]

FxObjectHandleGetPtr	(	GetFxDriverGlobals(DriverGlobals)	,
		Device	,
		FX_TYPE_DEVICE	,
		(PVOID *) &	pDevice
	)

Referenced by __in_bcount_opt().

FxObjectHandleGetPtr() [2/3]

FxObjectHandleGetPtr	(	GetFxDriverGlobals(DriverGlobals)	,
		WmiInstance	,
		FX_TYPE_WMI_INSTANCE	,
		(PVOID *) &	pInstance
	)

FxObjectHandleGetPtr() [3/3]

FxObjectHandleGetPtr	(	GetFxDriverGlobals(DriverGlobals)	,
		WmiProvider	,
		FX_TYPE_WMI_PROVIDER	,
		(PVOID *) &	pProvider
	)

FxPointerNotNull() [1/3]

FxPointerNotNull	(	GetFxDriverGlobals(DriverGlobals)	,
		WmiProvider
	)

FxPointerNotNull() [2/3]

FxPointerNotNull	(	GetFxDriverGlobals(DriverGlobals)	,
		WmiProviderConfig
	)

FxPointerNotNull() [3/3]

FxPointerNotNull	(	pFxDriverGlobals	,
		InstanceConfig
	)

GetDevice()

return pProvider GetDevice

(

)

-> GetHandle()

GetProvider()

return pInstance GetProvider

(

)

-> GetHandle()

Referenced by Chkdsk(), and FormatEx().

GetTracingHandle()

return pProvider GetTracingHandle

(

)

if() [1/7]

if

(

!

NT_SUCCESSstatus

)

Definition at line 208 of file fxwmiapi.cpp.

                                 {
            return status;
        }

if() [2/7]

if

(

InstanceConfig->Provider !

= NULL && InstanceConfig->ProviderConfig != NULL

)

Definition at line 146 of file fxwmiapi.cpp.

                                                                            {
        status = STATUS_INVALID_PARAMETER;
 
        DoTraceLevelMessage(
            pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
            "InstanceConfig %p Provider %p and ProviderConfig %p are both not "
            "NULL, only one can be, %!STATUS!", InstanceConfig,
            InstanceConfig->Provider, InstanceConfig->ProviderConfig, status);
 
        return status;
    }

if() [3/7]

if

(

InstanceConfig->

Provider = = NULL && InstanceConfig->ProviderConfig == NULL

)

Definition at line 135 of file fxwmiapi.cpp.

                                                                            {
        status = STATUS_INVALID_PARAMETER;
 
        DoTraceLevelMessage(
            pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
            "InstanceConfig %p Provider and ProviderConfig are both NULL, only "
            "one can be, %!STATUS!", InstanceConfig, status);
 
        return status;
    }

if() [4/7]

if

(

InstanceConfig->Size !

= sizeof(WDF_WMI_INSTANCE_CONFIG)

)

Definition at line 126 of file fxwmiapi.cpp.

                                                                 {
        status = STATUS_INFO_LENGTH_MISMATCH;
        DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
                            "Expected InstanceConfig Size %d, got %d, %!STATUS!",
                            InstanceConfig->Size, sizeof(*InstanceConfig),
                            status);
        return status;
    }

if() [5/7]

if

(

NT_SUCCESS(status) &&InstanceConfig->

Register

)

Definition at line 225 of file fxwmiapi.cpp.

                                                        {
        status = pProvider->AddInstance(pInstance);
    }

if() [6/7]

if

(

NT_SUCCESS(status)

)

Definition at line 229 of file fxwmiapi.cpp.

                            {
        if (Instance != NULL) {
            *Instance = hInstance;
        }
    }

if() [7/7]

if

(

pDevice->m_PkgPnp->

IsPowerPolicyOwner() = = FALSE

)

Definition at line 72 of file fxwmiapi.cpp.

                                                 {
        ownerSettings = pDevice->m_PkgPnp->m_PowerPolicyMachine.m_Owner;
 
        if ((FxIsEqualGuid(&WmiProviderConfig->Guid,
                           &GUID_POWER_DEVICE_ENABLE) &&
             ownerSettings->m_IdleSettings.WmiInstance != NULL) ||
 
            (FxIsEqualGuid(&WmiProviderConfig->Guid,
                           &GUID_POWER_DEVICE_WAKE_ENABLE) &&
             ownerSettings->m_WakeSettings.WmiInstance != NULL)) {
 
            DoTraceLevelMessage(GetFxDriverGlobals(DriverGlobals), TRACE_LEVEL_ERROR,
                                TRACINGDEVICE, "WMI Guid already registered by "
                                "framework");
            return STATUS_WMI_GUID_DISCONNECTED;
        }
    }

IsEnabled()

return pProvider IsEnabled

(

ProviderControl

)

Referenced by AdjustEnableDefaultPriv(), DECLARE_INTERFACE_(), DiskEtwEnableCallback(), IsDeviceStarted(), and SbDspIsSpeakerEnabled().

RemoveInstance()

pProvider RemoveInstance

(

pInstance

)

Variable Documentation

Device

_Must_inspect_result_ __in WDFDEVICE Device

Definition at line 46 of file fxwmiapi.cpp.

else

else

Initial value:

{
        FxDevice* pDevice

Definition at line 166 of file fxwmiapi.cpp.

EventDataSize

_Must_inspect_result_ __in WDFWMIINSTANCE __in_opt ULONG EventDataSize

Definition at line 416 of file fxwmiapi.cpp.

hInstance

WDFWMIINSTANCE hInstance

Definition at line 118 of file fxwmiapi.cpp.

Referenced by if().

hProvider

hProvider = NULL

Definition at line 169 of file fxwmiapi.cpp.

Referenced by FxWmiProvider::_Create(), DllRegisterServer(), NPSGetProviderNameA(), and NPSGetSectionNameA().

Instance

_Must_inspect_result_ __in WDFDEVICE __in PWDF_WMI_INSTANCE_CONFIG __in_opt PWDF_OBJECT_ATTRIBUTES __out_opt WDFWMIINSTANCE* Instance

Initial value:

{
    PFX_DRIVER_GLOBALS pFxDriverGlobals

Definition at line 112 of file fxwmiapi.cpp.

InstanceAttributes

_Must_inspect_result_ __in WDFDEVICE __in PWDF_WMI_INSTANCE_CONFIG __in_opt PWDF_OBJECT_ATTRIBUTES InstanceAttributes

Definition at line 110 of file fxwmiapi.cpp.

InstanceConfig

_Must_inspect_result_ __in WDFDEVICE __in PWDF_WMI_INSTANCE_CONFIG InstanceConfig

Definition at line 108 of file fxwmiapi.cpp.

ownerSettings

FxPowerPolicyOwnerSettings * ownerSettings

Definition at line 56 of file fxwmiapi.cpp.

Referenced by if().

pFxDriverGlobals

pFxDriverGlobals = GetFxDriverGlobals(DriverGlobals)

Definition at line 121 of file fxwmiapi.cpp.

Referenced by if().

pInstance

pInstance = NULL

Definition at line 117 of file fxwmiapi.cpp.

Referenced by __in_bcount_opt(), FxWmiInstanceExternal::_Create(), FxWmiIrpHandler::_QueryAllData(), FxWmiIrpHandler::AddPowerPolicyProviderAndInstance(), DdeAbandonTransaction(), DdeConnect(), DdeCreateDataHandle(), DdeCreateStringHandleA(), DdeCreateStringHandleW(), DdeEnableCallback(), DdeFreeStringHandle(), DdeGetLastError(), DdeKeepStringHandle(), DdeNameService(), DdePostAdvise(), DdeQueryStringA(), DdeQueryStringW(), DdeUninitialize(), FxWmiIrpHandler::Dispatch(), FxWmiProvider::GetInstanceReferenced(), if(), WDML_AddConv(), WDML_AddLink(), WDML_AddServer(), WDML_AllocTransaction(), WDML_ClientProc(), WDML_CreateServerConv(), WDML_CreateString(), WDML_DecHSZ(), WDML_EventProc(), WDML_FindConv(), WDML_FindLink(), WDML_FindNode(), WDML_FindServer(), WDML_FreeAllHSZ(), WDML_FreeTransaction(), WDML_GetInstance(), WDML_IncHSZ(), WDML_IncrementInstanceId(), WDML_Initialize(), WDML_InsertHSZNode(), WDML_InvokeCallback(), WDML_MakeHszFromAtom(), WDML_NotifyThreadDetach(), WDML_RemoveAllLinks(), WDML_RemoveLink(), WDML_RemoveServer(), WDML_ServerConvProc(), WDML_ServerNameProc(), and WDML_SetAllLastError().

pProvider

FxWmiProvider * pProvider = pInstance->GetProvider()

Definition at line 57 of file fxwmiapi.cpp.

Referenced by FxWmiProvider::_Create(), FxWmiIrpHandler::_RegInfo(), CicBridge::ActivateIMMX(), FxWmiIrpHandler::AddPowerPolicyProviderAndInstance(), CicBridge::ConfigureGeneral(), CicBridge::ConfigureRegisterWord(), CryptAcquireContextA(), FxWmiIrpHandler::Dispatch(), FxWmiIrpHandler::FindProviderLocked(), FxWmiIrpHandler::FindProviderReferenced(), if(), and pointer_default().

ProviderAttributes

_Must_inspect_result_ __in WDFDEVICE __in PWDF_WMI_PROVIDER_CONFIG __in_opt PWDF_OBJECT_ATTRIBUTES ProviderAttributes

Definition at line 50 of file fxwmiapi.cpp.

ProviderControl

__in WDFWMIPROVIDER __in WDF_WMI_PROVIDER_CONTROL ProviderControl

Initial value:

{
    FxWmiProvider *pProvider

Definition at line 286 of file fxwmiapi.cpp.

status

status

Initial value:

= FxWmiProvider::_Create(pFxDriverGlobals,
                                        Device,
                                        NULL,
                                        InstanceConfig->ProviderConfig,
                                        &hProvider,
                                        &pProvider)

Definition at line 119 of file fxwmiapi.cpp.

Referenced by __in_bcount_opt(), and if().

WmiInstance

_Must_inspect_result_ __in WDFWMIINSTANCE WmiInstance

Initial value:

{
    FxWmiInstanceExternal* pInstance

Definition at line 327 of file fxwmiapi.cpp.

WmiProvider

__in WDFWMIPROVIDER WmiProvider

Initial value:

{
    FxDevice* pDevice

Definition at line 52 of file fxwmiapi.cpp.

WmiProviderConfig

_Must_inspect_result_ __in WDFDEVICE __in PWDF_WMI_PROVIDER_CONFIG WmiProviderConfig

Definition at line 48 of file fxwmiapi.cpp.