Compartir a través de


EVT_UCX_USBDEVICE_GET_CHARACTERISTIC función de devolución de llamada (ucxusbdevice.h)

UCX invoca esta devolución de llamada para recuperar las características del dispositivo.

Sintaxis

EVT_UCX_USBDEVICE_GET_CHARACTERISTIC EvtUcxUsbdeviceGetCharacteristic;

NTSTATUS EvtUcxUsbdeviceGetCharacteristic(
  [in]      UCXCONTROLLER UcxController,
  [in]      UCXUSBDEVICE UcxUsbDevice,
  [in, out] PUCX_USBDEVICE_CHARACTERISTIC UcxUsbDeviceCharacteristic
)
{...}

Parámetros

[in] UcxController

Identificador del controlador UCX que el controlador cliente recibió en una llamada anterior al método ucxControllerCreate .

[in] UcxUsbDevice

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

[in, out] UcxUsbDeviceCharacteristic

Puntero a una estructura UCX_USBDEVICE_CHARACTERISTIC que contiene el tipo de característica en el que está interesado el autor de la llamada. El controlador cliente rellena el valor de la característica solicitada. Por ejemplo, si el tipo indica UCX_USBDEVICE_CHARACTERISTIC_PATH_DELAY, el controlador rellena la estructura UCX_USBDEVICE_CHARACTERISTIC_PATH_DELAY, a la que apunta miembro pathDelay, con los valores máximos adecuados y de retraso de ruta de acceso de envío.

Valor devuelto

Si la operación se realiza correctamente, la función de devolución de llamada debe devolver STATUS_SUCCESS u otro valor de estado para el que NT_SUCCESS(status) es igual a TRUE. De lo contrario, debe devolver un valor de estado para el que NT_SUCCESS(status) es igual a FALSE.

Observaciones

El controlador cliente UCX registra su implementación con la extensión del controlador de host USB (UCX) llamando al método UcxUsbDeviceCreate.

Requisitos

Requisito Valor
cliente mínimo admitido Windows 10, versión 1709
servidor mínimo admitido Windows Server 2016
de la plataforma de destino de Windows
versión mínima de KMDF 1.0
versión mínima de UMDF 2.0
encabezado de ucxusbdevice.h (include Ucxclass.h)
irQL <=DISPATCH_LEVEL