Función UcxEndpointCreate (ucxendpoint.h)

Crea un punto de conexión en el objeto de dispositivo USB especificado.

Sintaxis

NTSTATUS UcxEndpointCreate(
  [in]           UCXUSBDEVICE           UsbDevice,
  [out]          PUCXENDPOINT_INIT      *EndpointInit,
  [in, optional] PWDF_OBJECT_ATTRIBUTES Attributes,
  [out]          UCXENDPOINT            *Endpoint
);

Parámetros

[in] UsbDevice

Identificador del objeto de dispositivo USB que contiene el punto de conexión. El controlador cliente recuperó el identificador en una llamada anterior a UcxUsbDeviceCreate.

[out] EndpointInit

Puntero a una estructura de UCXENDPOINT_INIT que describe varias operaciones de configuración para crear el objeto de punto de conexión. El controlador especifica punteros de función a sus funciones de devolución de llamada en esta estructura. Esta estructura se administra mediante UCX.

[in, optional] Attributes

Puntero a una estructura de WDF_OBJECT_ATTRIBUTES asignada por el autor de la llamada que especifica los atributos del objeto de punto de conexión.

[out] Endpoint

Puntero a una variable que recibe un identificador para el nuevo objeto de punto de conexión.

Valor devuelto

El método devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, este método podría devolver uno adecuado código de error NTSTATUS.

Observaciones

El controlador de cliente del controlador de host debe llamar a este método después de la llamada WdfDeviceCreate. El elemento primario del nuevo objeto de punto de conexión es el objeto de dispositivo USB.

El método inicializa el objeto de punto de conexión con información como el tipo de punto de conexión, canalización, transferencia y tamaño máximo de las transferencias.

Para obtener un ejemplo de código, consulte EVT_UCX_USBDEVICE_ENDPOINT_ADD.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 10
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	ucxendpoint.h (incluya Ucxclass.h, Ucxendpoint.h)
irQL	PASSIVE_LEVEL