Compartir a través de

Función UcxEndpointCreate (ucxendpoint.h)

  • Artículo

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 atributos para el 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 un código de error NTSTATUS adecuado.

Comentarios

El controlador de cliente para el 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, la canalización, la transferencia y el tamaño máximo de las transferencias.

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

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10
Plataforma de destino Windows
Versión mínima de KMDF 1.0
Versión mínima de UMDF 2.0
Encabezado ucxendpoint.h (include Ucxclass.h, Ucxendpoint.h)
IRQL PASSIVE_LEVEL