#include <fxwmiinstance.hpp>

Inheritance diagram for FxWmiInstanceExternal:

[legend]

Collaboration diagram for FxWmiInstanceExternal:

[legend]

Public Member Functions
	FxWmiInstanceExternal (__in PFX_DRIVER_GLOBALS FxDriverGlobals, __in PWDF_WMI_INSTANCE_CONFIG Config, __in FxWmiProvider *Provider)

VOID	SetContextForQueryLength (__in ULONG ContextSize)

Public Member Functions inherited from FxWmiInstance
	FxWmiInstance (__in PFX_DRIVER_GLOBALS FxDriverGlobals, __in USHORT ObjectSize, __in FxWmiProvider *Provider)

	~FxWmiInstance ()

CfxDevice *	GetDevice (VOID)

FxWmiProvider *	GetProvider (VOID)

_Must_inspect_result_ NTSTATUS	FireEvent (__in_bcount_opt(EventBufferSize) PVOID EventBuffer, __inout ULONG EventBufferSize)

BOOLEAN	IsEnabled (__in WDF_WMI_PROVIDER_CONTROL Control)

WDFWMIINSTANCE	GetHandle (VOID)

virtual BOOLEAN	IsQueryInstanceSupported (VOID)=0

virtual _Must_inspect_result_ __drv_sameIRQL	__drv_maxIRQL (PASSIVE_LEVEL) NTSTATUS QueryInstance(__in ULONG OutBufferSize

virtual _Must_inspect_result_ __drv_sameIRQL	__out_bcount_part (OutBufferSize, *BufferUsed) PVOID OutBuffer

virtual BOOLEAN	IsSetInstanceSupported (VOID)=0

virtual _Must_inspect_result_ __drv_sameIRQL	__drv_maxIRQL (PASSIVE_LEVEL) NTSTATUS SetInstance(__in ULONG InBufferSize

virtual _Must_inspect_result_ __drv_sameIRQL	__in_bcount (InBufferSize) PVOID InBuffer)=0

virtual BOOLEAN	IsSetItemSupported (VOID)=0

virtual _Must_inspect_result_ __drv_sameIRQL	__drv_maxIRQL (PASSIVE_LEVEL) NTSTATUS SetItem(__in ULONG DataItemId

virtual _Must_inspect_result_ __drv_sameIRQL __in ULONG	__in_bcount (InBufferSize) PVOID InBuffer)=0

virtual BOOLEAN	IsExecuteMethodSupported (VOID)=0

virtual _Must_inspect_result_ __drv_sameIRQL	__drv_maxIRQL (PASSIVE_LEVEL) NTSTATUS ExecuteMethod(__in ULONG MethodId

virtual _Must_inspect_result_ __drv_sameIRQL __in ULONG __inout ULONG	__drv_when (InBufferSize >=OutBufferSize, __inout_bcount(InBufferSize)) __drv_when(InBufferSize< OutBufferSize

virtual _Must_inspect_result_ __drv_sameIRQL __in ULONG __inout ULONG	__inout_bcount (OutBufferSize)) PVOID Buffer

virtual BOOLEAN	Dispose (VOID)

Public Member Functions inherited from FxNonPagedObject
	FxNonPagedObject (__in WDFTYPE Type, __in USHORT Size, __in PFX_DRIVER_GLOBALS FxDriverGlobals)

	FxNonPagedObject (__in WDFTYPE Type, __in USHORT Size, __in PFX_DRIVER_GLOBALS FxDriverGlobals, __in FxObjectType ObjectType)

virtual	~FxNonPagedObject (VOID)

	_Acquires_lock_ (this->m_NPLock.m_Lock) __drv_maxIRQL(DISPATCH_LEVEL) __drv_setsIRQL(DISPATCH_LEVEL) VOID Lock(__out __drv_deref(__drv_savesIRQL) PKIRQL PreviousIrql)

	_Releases_lock_ (this->m_NPLock.m_Lock) __drv_requiresIRQL(DISPATCH_LEVEL) __inline VOID Unlock(__in __drv_restoresIRQL KIRQL PreviousIrql)

	_Acquires_lock_ (this->m_NPLock.m_Lock) __drv_requiresIRQL(DISPATCH_LEVEL) VOID LockAtDispatch(VOID)

	_Requires_lock_held_ (this->m_NPLock.m_Lock) _Releases_lock_(this -> m_NPLock.m_Lock) __drv_requiresIRQL(DISPATCH_LEVEL) __inline VOID UnlockFromDispatch(VOID)

Public Member Functions inherited from FxObject
PVOID	GetCOMWrapper ()

void	SetCOMWrapper (__drv_aliasesMem PVOID Wrapper)

	FxObject (__in WDFTYPE Type, __in USHORT Size, __in PFX_DRIVER_GLOBALS FxDriverGlobals)

virtual	~FxObject (VOID)

PVOID __inline	operator new (__in size_t Size, __in PFX_DRIVER_GLOBALS FxDriverGlobals, __in FxObjectType Type)

PVOID __inline	operator new (__in size_t Size, __in PFX_DRIVER_GLOBALS FxDriverGlobals, __in_opt PWDF_OBJECT_ATTRIBUTES Attributes, __in USHORT ExtraSize=0)

VOID	operator delete (__in PVOID Memory)

VOID	SetNoContextHeader (VOID)

PVOID __inline	GetObjectHandle (VOID)

__inline FxContextHeader *	GetContextHeader (VOID)

__inline PFX_DRIVER_GLOBALS	GetDriverGlobals (VOID)

WDFTYPE	GetType (VOID)

USHORT	GetObjectSize (VOID)

LONG	GetRefCnt (VOID)

FxTagTracker *	GetTagTracker (VOID)

CfxDevice *	GetDevice (VOID)

CfxDeviceBase *	GetDeviceBase (VOID)

VOID	SetDeviceBase (__in CfxDeviceBase *DeviceBase)

__inline VOID	CallCleanup (VOID)

ULONG __inline	AddRef (__in_opt PVOID Tag=NULL, __in LONG Line=0, __in_opt PSTR File=NULL)

virtual ULONG	Release (__in_opt PVOID Tag=NULL, __in LONG Line=0, __in_opt PSTR File=NULL)

virtual ULONG	AddRefOverride (__in WDFOBJECT_OFFSET Offset, __in_opt PVOID Tag=NULL, __in LONG Line=0, __in_opt PSTR File=NULL)

virtual ULONG	ReleaseOverride (__in WDFOBJECT_OFFSET Offset, __in_opt PVOID Tag=NULL, __in LONG Line=0, __in_opt PSTR File=NULL)

virtual _Must_inspect_result_ NTSTATUS	QueryInterface (__in FxQueryInterfaceParams *Params)

VOID	MarkTraceState (VOID)

BOOLEAN __inline	IsTraceState (VOID)

VOID __inline	TraceDroppedEvent (__in FxObjectDroppedEvent Event)

VOID	MarkPassiveDispose (__in FxObjectLockState State=ObjectLock)

VOID	MarkPassiveCallbacks (__in FxObjectLockState State=ObjectLock)

VOID	MarkForceDisposeThread (__in FxObjectLockState State=ObjectLock)

BOOLEAN	IsPassiveCallbacks (__in BOOLEAN AcquireLock=TRUE)

BOOLEAN	IsPassiveDispose (__in BOOLEAN AcquireLock=TRUE)

BOOLEAN	IsForceDisposeThread (__in BOOLEAN AcquireLock=TRUE)

VOID	MarkCommitted (VOID)

BOOLEAN	IsCommitted (VOID)

VOID	MarkDisposeOverride (__in FxObjectLockState State=ObjectLock)

VOID	MarkNoDeleteDDI (__in FxObjectLockState State=ObjectLock)

BOOLEAN	IsNoDeleteDDI (VOID)

_Must_inspect_result_ NTSTATUS	Commit (__in_opt PWDF_OBJECT_ATTRIBUTES Attributes, __out_opt WDFOBJECT ObjectHandle, __in_opt FxObject Parent=NULL, __in BOOLEAN AssignDriverAsDefaultParent=TRUE)

VOID	DeleteFromFailedCreate (VOID)

VOID	ClearEvtCallbacks (VOID)

BOOLEAN	EarlyDispose (VOID)

virtual VOID	DeleteObject (VOID)

virtual BOOLEAN	Dispose (VOID)

_Must_inspect_result_ NTSTATUS	AssignParentObject (__in FxObject *ParentObject)

_Must_inspect_result_ NTSTATUS	AddContext (__in FxContextHeader Header, __in PVOID Context, __in PWDF_OBJECT_ATTRIBUTES Attributes)

_Must_inspect_result_ NTSTATUS	RemoveParentAssignment (VOID)

_Must_inspect_result_ FxObject *	GetParentObjectReferenced (__in PVOID Tag)

BOOLEAN	IsDisposed (VOID)

Static Public Member Functions
static _Must_inspect_result_ NTSTATUS	_Create (__in PFX_DRIVER_GLOBALS FxDriverGlobals, __in FxWmiProvider Provider, __in PWDF_WMI_INSTANCE_CONFIG WmiInstanceConfig, __in_opt PWDF_OBJECT_ATTRIBUTES InstanceAttributes, __out WDFWMIINSTANCE WmiInstance, __out FxWmiInstanceExternal **Instance)

Static Public Member Functions inherited from FxObject
static FxObject *	_FromDisposeEntry (__in PSINGLE_LIST_ENTRY Entry)

static FxObject *	_GetObjectFromHandle (__in WDFOBJECT Handle, __inout PWDFOBJECT_OFFSET ObjectOffset)

static PVOID __inline	_ToHandle (__in FxObject *Object)

static VOID __inline	_ReferenceActual (__in WDFOBJECT Object, __in_opt PVOID Tag, __in LONG Line, __in PSTR File)

static VOID __inline	_DereferenceActual (__in WDFOBJECT Object, __in_opt PVOID Tag, __in LONG Line, __in PSTR File)

static PVOID	_GetDebugBase (__in FxObject *Object)

static PFX_POOL_HEADER	_CleanupPointer (__in PFX_DRIVER_GLOBALS FxDriverGlobals, __in FxObject *Object)

static _Must_inspect_result_ NTSTATUS	_GetEffectiveLock (__in FxObject Object, __in_opt IFxHasCallbacks Callbacks, __in BOOLEAN AutomaticLocking, __in BOOLEAN PassiveCallbacks, __out FxCallbackLock CallbackLock, __out_opt FxObject CallbackLockObject)

static _Must_inspect_result_ NTSTATUS	_ObjectQuery (_In_ FxObject Object, _In_ CONST GUID Guid, _In_ ULONG QueryBufferLength, _Out_writes_bytes_(QueryBufferLength) PVOID QueryBuffer)

Protected Member Functions
virtual BOOLEAN	IsQueryInstanceSupported (VOID)

virtual _Must_inspect_result_ __drv_sameIRQL	__drv_maxIRQL (PASSIVE_LEVEL) NTSTATUS QueryInstance(__inout ULONG OutBufferSize

virtual _Must_inspect_result_ __drv_sameIRQL	__out_xcount (OutBuffer->size) PVOID OutBuffer

virtual BOOLEAN	IsSetInstanceSupported (VOID)

virtual _Must_inspect_result_ __drv_sameIRQL	__drv_maxIRQL (PASSIVE_LEVEL) NTSTATUS SetInstance(__in ULONG InBufferSize

virtual _Must_inspect_result_ __drv_sameIRQL	__in_bcount (InBufferSize) PVOID InBuffer)

virtual BOOLEAN	IsSetItemSupported (VOID)

virtual _Must_inspect_result_ __drv_sameIRQL	__drv_maxIRQL (PASSIVE_LEVEL) NTSTATUS SetItem(__in ULONG DataItemId

virtual _Must_inspect_result_ __drv_sameIRQL __in ULONG	__in_bcount (InBufferSize) PVOID InBuffer)

virtual BOOLEAN	IsExecuteMethodSupported (VOID)

virtual _Must_inspect_result_ __drv_sameIRQL	__drv_maxIRQL (PASSIVE_LEVEL) NTSTATUS ExecuteMethod(__in ULONG MethodId

virtual _Must_inspect_result_ __drv_sameIRQL __in ULONG __inout ULONG	__drv_when (InBufferSize >=OutBufferSize, __inout_bcount(InBufferSize)) __drv_when(InBufferSize< OutBufferSize

virtual _Must_inspect_result_ __drv_sameIRQL __in ULONG __inout ULONG	__inout_bcount (OutBufferSize)) PVOID Buffer

Protected Member Functions inherited from FxObject
	FxObject (__in WDFTYPE Type, __in USHORT Size, __in PFX_DRIVER_GLOBALS FxDriverGlobals, __in FxObjectType ObjectType)

FxObjectDebugExtension *	GetDebugExtension (VOID)

BOOLEAN	IsDebug (VOID)

VOID	AllocateTagTracker (__in WDFTYPE Type)

virtual VOID	SelfDestruct (VOID)

PVOID __inline	GetObjectHandleUnchecked (VOID)

VOID __inline	DestroyChildren (VOID)

VOID	DeleteEarlyDisposedObject (VOID)

Protected Attributes
virtual _Must_inspect_result_ __drv_sameIRQL __out PULONG	BufferUsed

virtual _Must_inspect_result_ __drv_sameIRQL __in ULONG	InBufferSize

virtual _Must_inspect_result_ __drv_sameIRQL __in ULONG __inout ULONG	OutBufferSize

virtual _Must_inspect_result_ __drv_sameIRQL __in ULONG __inout ULONG __out PULONG	BufferUsed

FxWmiInstanceQueryInstanceCallback	m_QueryInstanceCallback

FxWmiInstanceSetInstanceCallback	m_SetInstanceCallback

FxWmiInstanceSetItemCallback	m_SetItemCallback

FxWmiInstanceExecuteMethodCallback	m_ExecuteMethodCallback

ULONG	m_ContextLength

BOOLEAN	m_UseContextForQuery

Protected Attributes inherited from FxWmiInstance
LIST_ENTRY	m_ListEntry

FxWmiProvider *	m_Provider

Protected Attributes inherited from FxObject
union {
CfxDeviceBase * m_DeviceBase

CfxDevice * m_Device

};

Additional Inherited Members
Public Attributes inherited from FxWmiInstance
virtual _Must_inspect_result_ __drv_sameIRQL __out PULONG	BufferUsed =0

virtual _Must_inspect_result_ __drv_sameIRQL __in ULONG	InBufferSize

virtual _Must_inspect_result_ __drv_sameIRQL __in ULONG __inout ULONG	OutBufferSize

virtual _Must_inspect_result_ __drv_sameIRQL __in ULONG __inout ULONG __out PULONG	BufferUsed =0

Static Protected Member Functions inherited from FxObject
static PVOID	_GetBase (__in FxObject *Object)

Detailed Description

Definition at line 370 of file fxwmiinstance.hpp.

Constructor & Destructor Documentation

◆ FxWmiInstanceExternal()

FxWmiInstanceExternal::FxWmiInstanceExternal	(	__in PFX_DRIVER_GLOBALS	FxDriverGlobals,
		__in PWDF_WMI_INSTANCE_CONFIG	Config,
		__in FxWmiProvider *	Provider
	)

Definition at line 128 of file fxwmiinstance.cpp.

      :
    FxWmiInstance(FxDriverGlobals, sizeof(FxWmiInstanceExternal), Provider),
    m_QueryInstanceCallback(FxDriverGlobals),
    m_SetInstanceCallback(FxDriverGlobals),
    m_SetItemCallback(FxDriverGlobals),
    m_ExecuteMethodCallback(FxDriverGlobals)
{
    m_ContextLength = 0;
    m_UseContextForQuery = Config->UseContextForQuery;
 
    if (m_UseContextForQuery == FALSE) {
        m_QueryInstanceCallback.m_Method = Config->EvtWmiInstanceQueryInstance;
    }
    m_SetInstanceCallback.m_Method = Config->EvtWmiInstanceSetInstance;
    m_SetItemCallback.m_Method = Config->EvtWmiInstanceSetItem;
 
    m_ExecuteMethodCallback.m_Method = Config->EvtWmiInstanceExecuteMethod;
}

Member Function Documentation

◆ __drv_maxIRQL() [1/4]

virtual _Must_inspect_result_ __drv_sameIRQL FxWmiInstanceExternal::__drv_maxIRQL ( PASSIVE_LEVEL )

protectedvirtual

Reimplemented from FxWmiInstance.

◆ __drv_maxIRQL() [2/4]

virtual _Must_inspect_result_ __drv_sameIRQL FxWmiInstanceExternal::__drv_maxIRQL ( PASSIVE_LEVEL )

protectedvirtual

Reimplemented from FxWmiInstance.

◆ __drv_maxIRQL() [3/4]

virtual _Must_inspect_result_ __drv_sameIRQL FxWmiInstanceExternal::__drv_maxIRQL ( PASSIVE_LEVEL )

protectedvirtual

Reimplemented from FxWmiInstance.

◆ __drv_maxIRQL() [4/4]

virtual _Must_inspect_result_ __drv_sameIRQL FxWmiInstanceExternal::__drv_maxIRQL ( PASSIVE_LEVEL )

protectedvirtual

Reimplemented from FxWmiInstance.

◆ __drv_when()

virtual _Must_inspect_result_ __drv_sameIRQL __in ULONG __inout ULONG FxWmiInstanceExternal::__drv_when	(	InBufferSize >=	OutBufferSize,
		__inout_bcount(InBufferSize)
	)

protected

◆ __in_bcount() [1/2]

virtual _Must_inspect_result_ __drv_sameIRQL FxWmiInstanceExternal::__in_bcount ( InBufferSize )

protectedvirtual

Implements FxWmiInstance.

◆ __in_bcount() [2/2]

virtual _Must_inspect_result_ __drv_sameIRQL __in ULONG FxWmiInstanceExternal::__in_bcount ( InBufferSize )

protectedvirtual

Implements FxWmiInstance.

◆ __inout_bcount()

virtual _Must_inspect_result_ __drv_sameIRQL __in ULONG __inout ULONG FxWmiInstanceExternal::__inout_bcount ( OutBufferSize )

protected

◆ __out_xcount()

virtual _Must_inspect_result_ __drv_sameIRQL FxWmiInstanceExternal::__out_xcount ( OutBuffer-> size )

protected

◆ _Create()

_Must_inspect_result_ NTSTATUS FxWmiInstanceExternal::_Create	(	__in PFX_DRIVER_GLOBALS	FxDriverGlobals,
		__in FxWmiProvider *	Provider,
		__in PWDF_WMI_INSTANCE_CONFIG	WmiInstanceConfig,
		__in_opt PWDF_OBJECT_ATTRIBUTES	InstanceAttributes,
		__out WDFWMIINSTANCE *	WmiInstance,
		__out FxWmiInstanceExternal **	Instance
	)

static

Definition at line 153 of file fxwmiinstance.cpp.

{
    FxWmiInstanceExternal* pInstance;
    WDFWMIINSTANCE hInstance;
    NTSTATUS status;
    size_t contextSize;
 
    contextSize = 0;
    *Instance = 0;
 
    *WmiInstance = NULL;
 
    //
    // For event only providers, you cannot specify any callbacks or context
    // usage.
    //
    if (Provider->IsEventOnly() &&
        (WmiInstanceConfig->UseContextForQuery ||
         WmiInstanceConfig->EvtWmiInstanceQueryInstance != NULL ||
         WmiInstanceConfig->EvtWmiInstanceSetInstance != NULL ||
         WmiInstanceConfig->EvtWmiInstanceSetItem != NULL ||
         WmiInstanceConfig->EvtWmiInstanceExecuteMethod != NULL)) {
 
        status = STATUS_INVALID_PARAMETER;
 
        DoTraceLevelMessage(
            FxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
            "WDFWMIPROVIDER %p is event only and UseContextForQuery (%d) is TRUE,"
            " or a callback (query instance %p, set instance %p, set item %p, "
            "executue method %p) is not NULL, %!STATUS!",
            Provider->GetHandle(), WmiInstanceConfig->UseContextForQuery,
            WmiInstanceConfig->EvtWmiInstanceQueryInstance,
            WmiInstanceConfig->EvtWmiInstanceSetInstance,
            WmiInstanceConfig->EvtWmiInstanceSetItem,
            WmiInstanceConfig->EvtWmiInstanceExecuteMethod, status);
 
        return status;
    }
 
    status = FxValidateObjectAttributes(FxDriverGlobals,
                                        InstanceAttributes,
                                        FX_VALIDATE_OPTION_PARENT_NOT_ALLOWED);
    if (!NT_SUCCESS(status)) {
        return status;
    }
 
    if (WmiInstanceConfig->UseContextForQuery) {
        //
        // UseContextForQuery only supported for read only instances.
        // ExecuteMethod has undefined side affects, so we allow it.
        //
        if (WmiInstanceConfig->EvtWmiInstanceSetInstance != NULL ||
            WmiInstanceConfig->EvtWmiInstanceSetItem != NULL) {
            status = STATUS_INVALID_PARAMETER;
 
            DoTraceLevelMessage(
                FxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
                "UseContextForQuery set, i.e. a read only instance, but "
                "EvtWmiInstanceSetInstance %p or EvtWmiInstanceSetItem %p is "
                "set, %!STATUS!",
                WmiInstanceConfig->EvtWmiInstanceSetInstance,
                WmiInstanceConfig->EvtWmiInstanceSetItem, status);
 
            return status;
        }
 
        //
        // We must have a context to use for the query
        //
        if (InstanceAttributes == NULL ||
            InstanceAttributes->ContextTypeInfo == NULL) {
            status = STATUS_INVALID_PARAMETER;
 
            DoTraceLevelMessage(
                FxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
                "UseContextForQuery set, but InstanceAttributes %p is null or "
                "there is no associated type, %!STATUS!",
                InstanceAttributes, status);
 
            return status;
        }
 
        contextSize = InstanceAttributes->ContextTypeInfo->ContextSize;
 
        if (InstanceAttributes->ContextSizeOverride != 0) {
            status = RtlSizeTAdd(contextSize,
                                 InstanceAttributes->ContextSizeOverride,
                                 &contextSize);
            if (!NT_SUCCESS(status)) {
                DoTraceLevelMessage(
                    FxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
                    "Overlfow adding contextSize %I64d with size override %I64d, "
                    "%!STATUS!", contextSize,
                    InstanceAttributes->ContextSizeOverride, status);
 
                return status;
            }
        }
 
        if (contextSize > ULONG_MAX) {
            //
            // Since we are casting to a ULONG below, detect loss of data here
            // (only really applicable on 64 bit machines where sizeof(size_t) !=
            // sizeof(ULONG)
            //
            status = STATUS_INTEGER_OVERFLOW;
 
            DoTraceLevelMessage(
                FxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
                "context size %I64d can be %d large, %!STATUS!",
                contextSize, ULONG_MAX, status);
 
            return status;
        }
 
        //
        // Make sure the context is the minimum the buffer size.
        //
        if (contextSize < Provider->GetMinInstanceBufferSize()) {
            status = STATUS_BUFFER_TOO_SMALL;
 
            DoTraceLevelMessage(
                FxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
                "context size %I64d is less then the WDFWMIPROVIDER %p min size "
                "of %d, %!STATUS!",
                contextSize, Provider->GetHandle(),
                Provider->GetMinInstanceBufferSize(), status);
 
            return status;
        }
    }
 
    pInstance = new(FxDriverGlobals, InstanceAttributes)
        FxWmiInstanceExternal(FxDriverGlobals, WmiInstanceConfig, Provider);
 
    if (pInstance == NULL) {
        status = STATUS_INSUFFICIENT_RESOURCES;
 
        DoTraceLevelMessage(
            FxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
            "could not allocate memory for WDFWMIINSTANCE, %!STATUS!",
            status);
 
        return status;
    }
 
    if (contextSize > 0) {
        pInstance->SetContextForQueryLength((ULONG) contextSize);
    }
 
    if (NT_SUCCESS(status)) {
        status = pInstance->Commit(
            InstanceAttributes, (PWDFOBJECT) &hInstance, Provider);
 
        if (NT_SUCCESS(status)) {
            //
            // Assign the handle back to the caller.
            //
            *WmiInstance = hInstance;
        }
        else {
            //
            // On failure, DeleteFromFailedCreate will delete the object and
            // the Dispose callback will remove the instance from the provider's
            // list.
            //
            DO_NOTHING();
        }
    }
 
    if (NT_SUCCESS(status)) {
        *Instance = pInstance;
    }
    else {
        pInstance->DeleteFromFailedCreate();
    }
 
    return status;
}

◆ IsExecuteMethodSupported()

BOOLEAN FxWmiInstanceExternal::IsExecuteMethodSupported ( VOID )

protectedvirtual

Implements FxWmiInstance.

Definition at line 537 of file fxwmiinstance.cpp.

{
    return m_ExecuteMethodCallback.m_Method != NULL ? TRUE : FALSE;
}

◆ IsQueryInstanceSupported()

BOOLEAN FxWmiInstanceExternal::IsQueryInstanceSupported ( VOID )

protectedvirtual

Implements FxWmiInstance.

Definition at line 341 of file fxwmiinstance.cpp.

{
    //
    // If we have a function pointer to call or we are using the context
    // as the buffer, query instance is supported.
    //
    // Also, if neither of the first 2 are true, we need to support query
    // instance if the device has an execute method callback b/c WMI will
    // send a query instance to this instance which much succeed for the
    // execute method irp to be sent.
    //
    return (m_UseContextForQuery ||
            m_QueryInstanceCallback.m_Method != NULL ||
            m_ExecuteMethodCallback.m_Method != NULL) ? TRUE
                                                      : FALSE;
}

Referenced by FxWmiIrpHandler::_QueryAllData().

◆ IsSetInstanceSupported()

BOOLEAN FxWmiInstanceExternal::IsSetInstanceSupported ( VOID )

protectedvirtual

Implements FxWmiInstance.

Definition at line 485 of file fxwmiinstance.cpp.

{
    return m_SetInstanceCallback.m_Method != NULL ? TRUE : FALSE;
}

◆ IsSetItemSupported()

BOOLEAN FxWmiInstanceExternal::IsSetItemSupported ( VOID )

protectedvirtual

Implements FxWmiInstance.

Definition at line 510 of file fxwmiinstance.cpp.

{
    return m_SetItemCallback.m_Method != NULL ? TRUE : FALSE;
}

◆ SetContextForQueryLength()

VOID FxWmiInstanceExternal::SetContextForQueryLength ( __in ULONG ContextSize )

inline

Definition at line 379 of file fxwmiinstance.hpp.

    {
        m_ContextLength = ContextSize;
    }

Referenced by _Create().

Member Data Documentation

◆ BufferUsed [1/2]

virtual _Must_inspect_result_ __drv_sameIRQL __out PULONG FxWmiInstanceExternal::BufferUsed

protected

Definition at line 413 of file fxwmiinstance.hpp.

Referenced by __drv_maxIRQL().

◆ BufferUsed [2/2]

virtual _Must_inspect_result_ __drv_sameIRQL __in ULONG __inout ULONG __out PULONG FxWmiInstanceExternal::BufferUsed

protected

Definition at line 467 of file fxwmiinstance.hpp.

◆ InBufferSize

_Must_inspect_result_ __drv_sameIRQL __in ULONG FxWmiInstanceExternal::InBufferSize

protected

Definition at line 445 of file fxwmiinstance.hpp.

◆ m_ContextLength

ULONG FxWmiInstanceExternal::m_ContextLength

protected

Definition at line 482 of file fxwmiinstance.hpp.

Referenced by __drv_maxIRQL(), FxWmiInstanceExternal(), and SetContextForQueryLength().

◆ m_ExecuteMethodCallback

FxWmiInstanceExecuteMethodCallback FxWmiInstanceExternal::m_ExecuteMethodCallback

protected

Definition at line 480 of file fxwmiinstance.hpp.

Referenced by __drv_maxIRQL(), FxWmiInstanceExternal(), IsExecuteMethodSupported(), and IsQueryInstanceSupported().

◆ m_QueryInstanceCallback

FxWmiInstanceQueryInstanceCallback FxWmiInstanceExternal::m_QueryInstanceCallback

protected

Definition at line 474 of file fxwmiinstance.hpp.

Referenced by __drv_maxIRQL(), FxWmiInstanceExternal(), and IsQueryInstanceSupported().

◆ m_SetInstanceCallback

FxWmiInstanceSetInstanceCallback FxWmiInstanceExternal::m_SetInstanceCallback

protected

Definition at line 476 of file fxwmiinstance.hpp.

Referenced by FxWmiInstanceExternal(), and IsSetInstanceSupported().

◆ m_SetItemCallback

FxWmiInstanceSetItemCallback FxWmiInstanceExternal::m_SetItemCallback

protected

Definition at line 478 of file fxwmiinstance.hpp.

Referenced by FxWmiInstanceExternal(), and IsSetItemSupported().

◆ m_UseContextForQuery

BOOLEAN FxWmiInstanceExternal::m_UseContextForQuery

protected

Definition at line 484 of file fxwmiinstance.hpp.

Referenced by __drv_maxIRQL(), FxWmiInstanceExternal(), and IsQueryInstanceSupported().

◆ OutBufferSize

virtual _Must_inspect_result_ __drv_sameIRQL __in ULONG __inout ULONG FxWmiInstanceExternal::OutBufferSize

protected

Definition at line 463 of file fxwmiinstance.hpp.

Referenced by __drv_maxIRQL().

The documentation for this class was generated from the following files:

sdk/lib/drivers/wdf/shared/inc/private/common/fxwmiinstance.hpp
sdk/lib/drivers/wdf/kmdf/src/irphandlers/wmi/fxwmiinstance.cpp

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ FxWmiInstanceExternal()

Member Function Documentation

◆ __drv_maxIRQL() [1/4]

◆ __drv_maxIRQL() [2/4]

◆ __drv_maxIRQL() [3/4]

◆ __drv_maxIRQL() [4/4]

◆ __drv_when()

◆ __in_bcount() [1/2]

◆ __in_bcount() [2/2]

◆ __inout_bcount()

◆ __out_xcount()

◆ _Create()

◆ IsExecuteMethodSupported()

◆ IsQueryInstanceSupported()

◆ IsSetInstanceSupported()

◆ IsSetItemSupported()

◆ SetContextForQueryLength()

Member Data Documentation

◆ BufferUsed [1/2]

◆ BufferUsed [2/2]

◆ InBufferSize

◆ m_ContextLength

◆ m_ExecuteMethodCallback

◆ m_QueryInstanceCallback

◆ m_SetInstanceCallback

◆ m_SetItemCallback

◆ m_UseContextForQuery

◆ OutBufferSize