Función UdecxUsbDeviceInitSetEndpointsType (udecxusbdevice.h)

Artículo
02/26/2024

Indica el tipo de punto de conexión (simple o dinámico) en los parámetros de inicialización que usa el controlador cliente para crear el dispositivo USB virtual.

Sintaxis

void UdecxUsbDeviceInitSetEndpointsType(
  [in, out] PUDECXUSBDEVICE_INIT UdecxUsbDeviceInit,
  [in]      UDECX_ENDPOINT_TYPE  UdecxEndpointType
);

Parámetros

[in, out] UdecxUsbDeviceInit

Puntero a una estructura asignada por WDF que contiene parámetros de inicialización para el dispositivo USB virtual. El controlador cliente recuperó este puntero en la llamada anterior a UdecxUsbDeviceInitAllocate.

[in] UdecxEndpointType

Valor de tipo UDECX_ENDPOINT_TYPE que indica el tipo de punto de conexión USB.

Valor devuelto

None

Observaciones

Antes de crear el dispositivo USB virtual, el controlador cliente debe indicar el tipo de punto de conexión que admite. Puede admitir uno de los dos tipos (definidos en UDECX_ENDPOINT_TYPE):

Punto de conexión simple: el controlador cliente crea todos los objetos de punto de conexión antes de conectar el dispositivo. El dispositivo debe tener solo una configuración y una configuración de interfaz por interfaz.
Punto de conexión dinámico: el cliente crea objetos de punto de conexión en la función de devolución de llamada EVT_UDECX_USB_DEVICE_ENDPOINTS_CONFIGURE . La extensión de clase de emulación de dispositivo USB (UdeCx) invoca la implementación del controlador cuando obtiene una solicitud para agregar o configurar puntos de conexión.

UdecxUsbDeviceInit es una estructura opaca que contiene punteros a funciones de devolución de llamada relacionadas con puntos de conexión. Si el controlador cliente admite puntos de conexión dinámicos, el controlador debe implementar estas funciones de devolución de llamada:

Antes de llamar a este método, el controlador cliente debe haber establecido esos punteros llamando a UdecxUsbDeviceInitSetStateChangeCallbacks.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 10
Servidor mínimo compatible	Windows Server 2016
Plataforma de destino	Windows
Versión mínima de KMDF	1.15
Encabezado	udecxusbdevice.h (incluya Udecx.h)
Library	Udecxstub.lib
IRQL	PASSIVE_LEVEL