Метод ISensorDriver::OnClientDisconnect (sensorclassextension.h)

Статья
02/07/2025

Метод ISensorDriver::OnClientDisconnect уведомляет драйвер датчика об отключении клиентского приложения.

Синтаксис

HRESULT OnClientDisconnect(
  [in] IWDFFile *pClientFile,
  [in] LPWSTR   pwszSensorID
);

Параметры

[in] pClientFile

Указатель на интерфейс IWDFFile, представляющий объект файла для клиента, который отключен.

[in] pwszSensorID

LPWSTR, содержащий идентификатор датчика, от которого отключается клиентское приложение.

Возвращаемое значение

Если операция выполнена успешно, этот метод возвращает S_OK. В противном случае этот метод возвращает один из кодов ошибок, определенных в Winerror.h.

Замечания

Расширение класса датчика вызывает этот метод в следующих экземплярах:

Приложение закрывается обычно.
Пользователь отменяет разрешение на доступ к устройству, содержащее указанный датчик.
Работа по очистке от вызова к ISensorClassExtension::CleanupFile завершена.

Этот вызов можно использовать в качестве сигнала для обновления списков и ссылок подключенных приложений.

Дополнительные сведения об использовании этого метода см. в разделе Фильтрация данных.

Примеры

В следующем примере кода показана реализация ISensorDriver::OnClientDisconnect. Эта функция использует простую карту ATL с именем "Клиенты" для отслеживания подключенных клиентов. Пример добавления подключенных клиентов на карту см. в ISensorDriver::OnClientConnect.

Структура ClientData определяется следующим образом.

// Struct to keep track of connected client status.
struct ClientData
{
    BOOL bListening;  // Client is listening to events.
    ULONG ulInterval;  // Interval requested by client.
};

Определение функции следует.

HRESULT CSensorDdi:: OnClientDisconnect(
        __in IWDFFile* pClientFile,
        __in LPWSTR pwszSensorID
        )
{
    if(NULL == pClientFile ||
       NULL == pwszSensorID)
    {
        return E_POINTER;
    }

    HRESULT hr = S_OK;
    ClientData* pCD = NULL;
    BOOL bRet = FALSE;

    // Find this client in the map.
    pCD = Clients.Lookup(pClientFile);
    if(pCD == NULL)
    {
        hr = E_UNEXPECTED;
    }

    if(SUCCEEDED(hr))
    {
        // Free the client data memory.
        delete pCD;
        pCD = NULL;

        // Remove this client from the array.
        bRet = Clients.Remove(pClientFile);
        if(FALSE == bRet)
        {
            hr = E_UNEXPECTED;
        }
    }

    return hr;
}

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 7, доступно в Windows 7.
минимальный поддерживаемый сервер	Не поддерживается
целевая платформа	Настольный
заголовка	sensorclassextension.h
библиотеки	SensorClassExtension.lib

См. также

ISensorDriver

ISensorDriver::OnClientConnect

Поделиться через