UcxEndpointGetStaticStreamsReferenced 函数 (ucxendpoint.h)
返回指定终结点的引用静态流对象。
语法
UCXSSTREAMS UcxEndpointGetStaticStreamsReferenced(
[in] UCXENDPOINT Endpoint,
[in] PVOID Tag
);
参数
[in] Endpoint
为其请求静态流对象的终结点对象的句柄。 客户端驱动程序在上一次调用 UcxEndpointCreate 时检索了句柄。
[in] Tag
驱动程序定义的值,框架将其存储为对象引用的标识标记。
返回值
如果流对象是使用 终结点打开的,则为该对象的句柄。 否则为 NULL。
注解
客户端驱动程序可以使用此函数来确定它是否为此终结点创建了流对象。 如果创建 对象,该方法将返回 UCXSSTREAMS 句柄。 如果未创建对象,或者客户端驱动程序使 EVT_UCX_ENDPOINT_STATIC_STREAMS_ENABLE 回调中传递的框架请求对象失败,则该方法返回 NULL。 对此方法的任何调用都必须通过使用相同的 Tag 对 WdfObjectDereferenceWithTag 的调用进行匹配。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 10 |
目标平台 | Windows |
最低 KMDF 版本 | 1.0 |
最低 UMDF 版本 | 2.0 |
标头 | ucxendpoint.h (包括 Ucxclass.h、Ucxendpoint.h) |
IRQL | <=DISPATCH_LEVEL |