функция обратного вызова EVT_UFX_DEVICE_HOST_CONNECT (ufxclient.h)
Реализация драйвера клиента для запуска подключения к узлу.
Синтаксис
EVT_UFX_DEVICE_HOST_CONNECT EvtUfxDeviceHostConnect;
void EvtUfxDeviceHostConnect(
[in] UFXDEVICE unnamedParam1
)
{...}
Параметры
[in] unnamedParam1
Дескриптор объекта USB-устройства, полученного драйвером клиента при предыдущем вызове метода UfxDeviceCreate .
Возвращаемое значение
None
Remarks
Драйвер клиента для контроллера узла функции регистрирует свою реализацию EVT_UFX_DEVICE_HOST_CONNECT с расширением класса функций USB (UFX), вызывая метод UfxDeviceCreate .
Драйвер клиента не должен инициировать подключение к узлу, пока UFX не вызовет этот обратный вызов события. Драйвер клиента должен указывать на завершение этого события путем вызова метода UfxDeviceEventComplete .
Примеры
EVT_UFX_DEVICE_HOST_CONNECT UfxDevice_EvtDeviceHostConnect;
VOID
UfxDevice_EvtDeviceHostConnect (
_In_ UFXDEVICE UfxDevice
)
/*++
Routine Description:
EvtDeviceHostConnect callback handler for UFXDEVICE object.
Arguments:
UfxDevice - UFXDEVICE object representing the device.
--*/
{
PCONTROLLER_CONTEXT ControllerContext;
PUFXDEVICE_CONTEXT DeviceContext;
BOOLEAN EventComplete;
TraceEntry();
DeviceContext = UfxDeviceGetContext(UfxDevice);
ControllerContext = DeviceGetControllerContext(DeviceContext->FdoWdfDevice);
EventComplete = TRUE;
WdfSpinLockAcquire(ControllerContext->DpcLock);
//
// #### TODO: Insert code to set the run state on the controller ####
//
WdfSpinLockRelease(ControllerContext->DpcLock);
if (EventComplete) {
UfxDeviceEventComplete(UfxDevice, STATUS_SUCCESS);
}
TraceExit();
}
Требования
Требование | Значение |
---|---|
Целевая платформа | Windows |
Минимальная версия KMDF | 1,0 |
Минимальная версия UMDF | 2,0 |
Верхняя часть | ufxclient.h |
IRQL | <=DISPATCH_LEVEL |