IWDFObject::RetrieveContext method

The RetrieveContext method retrieves a context that was previously registered through the IWDFObject::AssignContext method.

Syntax


HRESULT RetrieveContext(
  [out] void **ppvContext
);

Parameters

ppvContext [out]

A pointer to a buffer that receives a pointer to the previously registered context.

Return value

RetrieveContext returns S_OK if the operation succeeds. Otherwise, this method returns one of the error codes that are defined in Winerror.h.

Remarks

Because the context is not a Component Object Model (COM) interface, the driver must not treat the context as such. For example, the driver cannot call the AddRef method on the context.

Examples

For a code example of how to use the RetrieveContext method, see IWDFIoQueue::GetDevice.

Requirements

Target platform

Desktop

End of support

Unavailable in UMDF 2.0 and later.

Minimum UMDF version

1.5

Header

Wudfddi.h (include Wudfddi.h)

DLL

WUDFx.dll

See also

IWDFObject
IWDFIoQueue::GetDevice
IWDFObject::AssignContext

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft