Funzione UcxEndpointCreate (ucxendpoint.h)

Articolo
02/27/2024

Crea un endpoint nell'oggetto dispositivo USB specificato.

Sintassi

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

Parametri

[in] UsbDevice

Handle per l'oggetto dispositivo USB che contiene l'endpoint. Il driver client ha recuperato l'handle in una chiamata precedente a UcxUsbDeviceCreate.

[out] EndpointInit

Puntatore a una struttura UCXENDPOINT_INIT che descrive varie operazioni di configurazione per la creazione dell'oggetto endpoint. Il driver specifica i puntatori di funzione alle relative funzioni di callback in questa struttura. Questa struttura è gestita da UCX.

[in, optional] Attributes

Puntatore a una struttura WDF_OBJECT_ATTRIBUTES allocata dal chiamante che specifica gli attributi per l'oggetto endpoint.

[out] Endpoint

Puntatore a una variabile che riceve un handle per il nuovo oggetto endpoint.

Valore restituito

Il metodo restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questo metodo potrebbe restituire un codice di errore NTSTATUS appropriato.

Commenti

Il driver client per il controller host deve chiamare questo metodo dopo la chiamata WdfDeviceCreate . L'elemento padre del nuovo oggetto endpoint è l'oggetto dispositivo USB.

Il metodo inizializza l'oggetto endpoint con informazioni quali il tipo di endpoint, pipe, trasferimento e dimensioni massime dei trasferimenti.

Per un esempio di codice, vedere EVT_UCX_USBDEVICE_ENDPOINT_ADD.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10
Piattaforma di destinazione	Windows
Versione KMDF minima	1.0
Versione UMDF minima	2,0
Intestazione	ucxendpoint.h (include Ucxclass.h, Ucxendpoint.h)
IRQL	PASSIVE_LEVEL

Condividi tramite