Funzione UcxStaticStreamsCreate (ucxsstreams.h)

Articolo
02/07/2025

Crea un oggetto flussi statici.

Sintassi

NTSTATUS UcxStaticStreamsCreate(
  [in]           UCXENDPOINT            Endpoint,
                 PUCXSSTREAMS_INIT      *StaticStreamsInit,
  [in, optional] PWDF_OBJECT_ATTRIBUTES Attributes,
                 UCXSSTREAMS            *StaticStreams
);

Parametri

[in] Endpoint

Handle per l'oggetto endpoint che supporta flussi statici. Il driver client ha recuperato l'handle in una chiamata precedente a UcxEndpointCreate.

StaticStreamsInit

Puntatore a una struttura UCXSSTREAMS_INIT che descrive varie operazioni di configurazione per la creazione dell'oggetto flusso. 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 flusso.

StaticStreams

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

Valore restituito

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

Osservazioni

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

In genere, il driver client chiama questo metodo nell'implementazione del callback dell'evento EVT_UCX_USBDEVICE_ENDPOINT_ADD.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 10
piattaforma di destinazione	Finestre
versione minima di KMDF	1.0
versione minima di UMDF	2.0
intestazione	ucxsstreams.h (include Ucxclass.h, Ucxstreams.h)
IRQL	PASSIVE_LEVEL

Condividi tramite