функция обратного вызова EVT_UFX_DEVICE_HOST_DISCONNECT (ufxclient.h)
Реализация драйвера клиента для отключения связи контроллера функции с узлом.
Синтаксис
EVT_UFX_DEVICE_HOST_DISCONNECT EvtUfxDeviceHostDisconnect;
void EvtUfxDeviceHostDisconnect(
[in] UFXDEVICE unnamedParam1
)
{...}
Параметры
[in] unnamedParam1
Дескриптор объекта USB-устройства, полученного драйвером клиента при предыдущем вызове метода UfxDeviceCreate .
Возвращаемое значение
None
Remarks
Драйвер клиента для контроллера узла функции регистрирует свою реализацию EVT_UFX_DEVICE_HOST_DISCONNECT с расширением класса функций USB (UFX), вызывая метод UfxDeviceCreate .
UFX вызывает этот обратный вызов события для выполнения обратимого отключения usb-кабеля. После этого вызова драйвер клиента не должен инициировать подключение к узлу, пока UFX не вызовет EVT_UFX_DEVICE_HOST_CONNECT.
Драйвер клиента указывает на завершение этого события путем вызова метода UfxDeviceEventComplete .
Примеры
EVT_UFX_DEVICE_HOST_DISCONNECT UfxDevice_EvtDeviceHostDisconnect;
VOID
UfxDevice_EvtDeviceHostDisconnect (
_In_ UFXDEVICE UfxDevice
)
/*++
Routine Description:
EvtDeviceHostDisconnect 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;
//
// #### TODO: Cancel all transfers. ####
//
WdfSpinLockAcquire(ControllerContext->DpcLock);
//
// #### TODO: Insert code to clear 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 |