Share via


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 de UCX_USBDEVICE_CHARACTERISTIC_PATH_DELAY , a la que apunta el miembro PathDelay , con los valores máximos y de retraso de ruta de envío adecuados.

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.

Comentarios

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 Value
Cliente mínimo compatible Windows 10, versión 1709
Servidor mínimo compatible Windows Server 2016
Plataforma de destino Windows
Versión mínima de KMDF 1.0
Versión mínima de UMDF 2.0
Encabezado ucxusbdevice.h (include Ucxclass.h)
IRQL <=DISPATCH_LEVEL