Récupération et définition des propriétés du capteur
Cette rubrique explique comment récupérer et définir des valeurs pour les propriétés du capteur. L’interface ISensor fournit les méthodes permettant de définir et de récupérer des valeurs pour les propriétés du capteur.
Récupération des propriétés du capteur
Vous pouvez récupérer certaines valeurs de propriété à partir d’un capteur avant que l’utilisateur ne l’ait activé. Des informations telles que le nom du fabricant ou le modèle du capteur peuvent vous aider à décider si votre programme peut utiliser le capteur.
Vous pouvez choisir de récupérer une seule valeur de propriété ou de récupérer une collection de valeurs de propriété ensemble. Pour récupérer une valeur unique, appelez ISensor::GetProperty. Pour récupérer une collection de valeurs, appelez ISensor::GetProperties. Vous pouvez récupérer toutes les propriétés d’un capteur en passant null via le premier paramètre à ISensor::GetProperties.
L’exemple de code suivant crée une fonction d’assistance qui imprime la valeur d’une propriété unique. La fonction reçoit un pointeur vers le capteur à partir duquel récupérer la valeur et une clé de propriété qui contient la propriété à imprimer. La fonction peut imprimer des valeurs pour des nombres, des chaînes et des GUID, mais pas d’autres types plus complexes.
HRESULT PrintSensorProperty(ISensor* pSensor, REFPROPERTYKEY pk)
{
assert(pSensor);
HRESULT hr = S_OK;
PROPVARIANT pv = {};
hr = pSensor->GetProperty(pk, &pv);
if(SUCCEEDED(hr))
{
if(pv.vt == VT_UI4) // Number
{
wprintf_s(L"\nSensor integer value: %u\n", pv.ulVal);
}
else if(pv.vt == VT_LPWSTR) // String
{
wprintf_s(L"\nSensor string value: %s\n", pv.pwszVal);
}
else if(pv.vt == VT_CLSID) // GUID
{
int iRet = 0;
// Convert the GUID to a string.
OLECHAR wszGuid[39] = {}; // Buffer for string.
iRet = ::StringFromGUID2(*(pv.puuid), wszGuid, 39);
assert(39 == iRet); // Count of characters returned for GUID.
wprintf_s(L"\nSensor GUID value: %s\n", wszGuid);
}
else // Interface or vector
{
wprintf_s(L"\nSensor property is a compound type. Unable to print value.");
}
}
PropVariantClear(&pv);
return hr;
}
L’exemple de code suivant crée une fonction qui récupère et imprime une collection de propriétés. L’ensemble de propriétés à imprimer est défini par le tableau nommé SensorProperties.
HRESULT PrintSensorProperties(ISensor* pSensor)
{
assert(pSensor);
HRESULT hr = S_OK;
DWORD cVals = 0; // Count of returned properties.
IPortableDeviceKeyCollection* pKeys = NULL; // Input
IPortableDeviceValues* pValues = NULL; // Output
// Properties to print.
const PROPERTYKEY SensorProperties[] =
{
SENSOR_PROPERTY_MANUFACTURER,
SENSOR_PROPERTY_SERIAL_NUMBER,
SENSOR_PROPERTY_DESCRIPTION,
SENSOR_PROPERTY_FRIENDLY_NAME
};
// CoCreate a key collection to store property keys.
hr = CoCreateInstance(CLSID_PortableDeviceKeyCollection,
NULL,
CLSCTX_INPROC_SERVER,
IID_PPV_ARGS(&pKeys));
if(SUCCEEDED(hr))
{
// Add the properties to the key collection.
for (DWORD dwIndex = 0; dwIndex < ARRAYSIZE(SensorProperties); dwIndex++)
{
hr = pKeys->Add(SensorProperties[dwIndex]);
if(FAILED(hr))
{
// Unexpected.
// This example returns the failed HRESULT.
// You may choose to ignore failures, here.
break;
}
}
}
if(SUCCEEDED(hr))
{
// Retrieve the properties from the sensor.
hr = pSensor->GetProperties(pKeys, &pValues);
}
if(SUCCEEDED(hr))
{
// Get the number of values returned.
hr = pValues->GetCount(&cVals);
}
if(SUCCEEDED(hr))
{
PROPERTYKEY pk; // Keys
PROPVARIANT pv = {}; // Values
// Loop through the values;
for (DWORD i = 0; i < cVals; i++)
{
// Get the value at the current index.
hr = pValues->GetAt(i, &pk, &pv);
if(SUCCEEDED(hr))
{
// Find and print the property.
if(IsEqualPropertyKey(pk, SENSOR_PROPERTY_MANUFACTURER))
{
wprintf_s(L"\nManufacturer: %s\n", pv.pwszVal);
}
else if(IsEqualPropertyKey(pk, SENSOR_PROPERTY_SERIAL_NUMBER))
{
wprintf_s(L"Serial number: %s\n", pv.pwszVal);
}
else if(IsEqualPropertyKey(pk, SENSOR_PROPERTY_FRIENDLY_NAME))
{
wprintf_s(L"Friendly name: %s\n", pv.pwszVal);
}
else if(IsEqualPropertyKey(pk, SENSOR_PROPERTY_DESCRIPTION))
{
wprintf_s(L"Description: %s\n", pv.pwszVal);
}
}
PropVariantClear(&pv);
} // end i loop
}
SafeRelease(&pKeys);
SafeRelease(&pValues);
return hr;
};
Définition des propriétés du capteur
Avant de pouvoir définir les valeurs de propriété d’un capteur, l’utilisateur doit activer le capteur. En outre, toutes les propriétés du capteur ne peuvent pas être définies.
Pour définir une ou plusieurs valeurs pour les propriétés, appelez ISensor::SetProperties. Vous fournissez à cette méthode un pointeur IPortableDeviceValues qui contient la collection de propriétés à définir et leurs valeurs associées. La méthode retourne une interface IPortableDeviceValues correspondante qui peut contenir des codes d’erreur pour les propriétés qui n’ont pas pu être définies.
L’exemple de code suivant crée une fonction d’assistance qui définit une nouvelle valeur pour la propriété SENSOR_PROPERTY_CURRENT_REPORT_INTERVAL. La fonction prend un pointeur vers le capteur pour lequel définir la propriété et une valeur ULONG qui indique le nouvel intervalle de rapport à définir. (Notez que la définition d’une valeur pour cette propriété particulière ne garantit pas que le capteur acceptera la valeur spécifiée. Pour plus d’informations sur le fonctionnement de cette propriété, consultez Propriétés du capteur .)
HRESULT SetCurrentReportInterval(ISensor* pSensor, ULONG ulNewInterval)
{
assert(pSensor);
HRESULT hr = S_OK;
IPortableDeviceValues* pPropsToSet = NULL; // Input
IPortableDeviceValues* pPropsReturn = NULL; // Output
// Create the input object.
hr = CoCreateInstance(__uuidof(PortableDeviceValues),
NULL,
CLSCTX_INPROC_SERVER,
IID_PPV_ARGS(&pPropsToSet));
if(SUCCEEDED(hr))
{
// Add the current report interval property.
hr = pPropsToSet->SetUnsignedIntegerValue(SENSOR_PROPERTY_CURRENT_REPORT_INTERVAL, ulNewInterval);
}
if(SUCCEEDED(hr))
{
// Only setting a single property, here.
hr = pSensor->SetProperties(pPropsToSet, &pPropsReturn);
}
// Test for failure.
if(hr == S_FALSE)
{
HRESULT hrError = S_OK;
// Check results for failure.
hr = pPropsReturn->GetErrorValue(SENSOR_PROPERTY_CURRENT_REPORT_INTERVAL, &hrError);
if(SUCCEEDED(hr))
{
// Print an error message.
wprintf_s(L"\nSetting current report interval failed with error 0x%X\n", hrError);
// Return the error code.
hr = hrError;
}
}
else if(hr == E_ACCESSDENIED)
{
// No permission. Take appropriate action.
}
SafeRelease(&pPropsToSet);
SafeRelease(&pPropsReturn);
return hr;
}
Rubriques connexes