UcxStaticStreamsCreate 函数 (ucxsstreams.h)

  • 项目

创建静态流对象。

语法

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

参数

[in] Endpoint

支持静态流的终结点对象的句柄。 客户端驱动程序在上一次调用 UcxEndpointCreate 时检索了句柄。

StaticStreamsInit

指向 UCXSSTREAMS_INIT 结构的指针，该结构描述用于创建流对象的各种配置操作。 驱动程序在此结构中指定指向其回调函数的函数指针。 此结构由 UCX 管理。

[in, optional] Attributes

指向调用方分配 的WDF_OBJECT_ATTRIBUTES 结构的指针，该结构指定流对象的属性。

StaticStreams

指向接收新流对象的句柄的变量的指针。

返回值

如果操作成功，该方法将返回STATUS_SUCCESS。 否则，此方法可能会返回相应的 NTSTATUS 错误代码。

注解

主控制器的客户端驱动程序必须在 WdfDeviceCreate 调用后调用此方法。 新终结点对象的父对象是终结点对象。

通常，客户端驱动程序在其 EVT_UCX_USBDEVICE_ENDPOINT_ADD 事件回调的实现中调用此方法。

要求

要求 值
最低受支持的客户端 Windows 10
目标平台 Windows
最低 KMDF 版本 1.0
最低 UMDF 版本 2.0
标头 ucxsstreams.h (包括 Ucxclass.h、Ucxstreams.h)
IRQL PASSIVE_LEVEL