ILogicalSensorManager::Connect method

Article
10/14/2015

[ILogicalSensorManager::Connect is no longer available for use as of Windows 8.]

Connects to a logical sensor.

Syntax

HRESULT Connect(
  [in] REFGUID        logicalID,
  [in] IPropertyStore *pPropertyStore
);

Parameters

logicalID [in]
REFGUID that identifies the logical sensor instance.

pPropertyStore [in]
Pointer to the IPropertyStore interface used to transfer data to the driver instance.

The property store can contain one or more of the following values.

Value	Meaning
PKEY_Device_HardwareIds	(VT_VECTOR\|VT_LPWSTR) Required. One or more hardware IDs for the driver to be loaded for the logical device instance. The device hardware ID is defined in the driver's INF file.
PKEY_Device_CompatibleIds	(VT_VECTOR\|VTLPWSTR) Optional. An array of compatible hardware IDs.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code	Description
S_OK	The method succeeded.
E_ACCESS_DENIED	No permission. Connecting a logical sensor requires administrator privileges. If you receive this error while debugging, restart the development environment as administrator.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)	The specified logical sensor is already connected.

Remarks

This method installs the specified logical sensor, if needed. If the logical sensor device node already exists, this method simply creates a connection to make the logical sensor available to the Sensor and Location Platform.

Examples

The following example code creates a helper method that connects to a specified logical sensor. The method parameters receive the sensor hardware ID and a unique GUID to identify the sensor.

HRESULT ConnectToLogicalSensor(PCWSTR* wszHardwareID, GUID guidLogicalID)
{
    HRESULT hr = S_OK;
    
    ILogicalSensorManager* pLSM = NULL;
    IPropertyStore* pStore = NULL;
    PROPVARIANT pv = {};

    // Create the property store.
    hr = PSCreateMemoryPropertyStore(IID_PPV_ARGS(&pStore));

    if(SUCCEEDED(hr))
    {
        // Create the logical sensor manager.
        hr = CoCreateInstance(CLSID_LogicalSensorManager, 
                                NULL, 
                                CLSCTX_INPROC_SERVER, 
                                IID_PPV_ARGS(&pLSM));
    }

    // Fill in the values.
    if(SUCCEEDED(hr))
    {
        hr = InitPropVariantFromStringVector(wszHardwareID, 1, &pv);
    }

    if(SUCCEEDED(hr))
    {
        hr = pStore->SetValue(PKEY_Device_HardwareIds, pv);
    }

    if(SUCCEEDED(hr))
    {
        hr = pStore->SetValue(PKEY_Device_CompatibleIds, pv);
    }

    if(SUCCEEDED(hr))
    {
        // Connect to the logical sensor.
        hr = pLSM->Connect(guidLogicalID, pStore);
    }

    SafeRelease(&pStore);
    SafeRelease(&pLSM);

    return hr;
}

Requirements

Minimum supported client	Windows 7 [desktop apps only]
Minimum supported server	None supported
End of client support	Windows 7
Header	Sensorsapi.h
Library	Sensorsapi.lib
DLL	Sensorsapi.dll