EVT_UFX_DEVICE_HOST_DISCONNECT función de devolución de llamada (ufxclient.h)

Artículo
08/07/2023

Implementación del controlador de cliente para deshabilitar la comunicación del controlador de función con el host.

Sintaxis

EVT_UFX_DEVICE_HOST_DISCONNECT EvtUfxDeviceHostDisconnect;

void EvtUfxDeviceHostDisconnect(
  [in] UFXDEVICE unnamedParam1
)
{...}

Parámetros

[in] unnamedParam1

Identificador de un objeto de dispositivo USB que el controlador cliente recibió en una llamada anterior al método UfxDeviceCreate .

Valor devuelto

None

Observaciones

El controlador de cliente para el controlador host de función registra su implementación de EVT_UFX_DEVICE_HOST_DISCONNECT con la extensión de clase de función USB (UFX) llamando al método UfxDeviceCreate .

UFX invoca esta devolución de llamada de evento para realizar una desconexión suave en el cable USB. Después de esta llamada, el controlador cliente no debe iniciar una conexión con el host hasta que UFX invoque EVT_UFX_DEVICE_HOST_CONNECT.

El controlador cliente indica la finalización de este evento llamando al método UfxDeviceEventComplete .

Ejemplos

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();
}

Requisitos

Requisito	Value
Plataforma de destino	Windows
Versión mínima de KMDF	1.0
Versión mínima de UMDF	2.0
Encabezado	ufxclient.h
IRQL	<=DISPATCH_LEVEL

Share via