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 の呼び出しと一致する必要があります。

要件

こちらもご覧ください

UcxEndpointCreate