次の方法で共有

RxCeQueryInformation 関数 (rxce.h)

  • [アーティクル]

RxCeQueryInformation は、呼び出し元によって割り当てられたバッファー内の接続に関する情報を照会します。

構文

NTSTATUS RxCeQueryInformation(
  [in]  IN PRXCE_VC                          pVc,
  [in]  IN RXCE_CONNECTION_INFORMATION_CLASS InformationClass,
  [out] OUT PVOID                            pInformation,
  [in]  IN ULONG                             Length
);

パラメーター

[in] pVc

この接続に関連付けられている仮想回線へのポインター。

[in] InformationClass

このクエリの種類に必要な情報クラス。 InformationClass に指定された値は、返される情報の種類を決定します。 このパラメーターは rxcehdlr.h で定義されている列挙であり、次のいずれかの値を指定できます。

RxCeTransportProviderInformation

プロバイダー情報をトランスポートに照会します。 成功すると、RXCE_TRANSPORT_PROVIDER_INFO構造体が pInformation バッファーにコピーされます。 RXCE_TRANSPORT_PROVIDER_INFOは、TDI_PROVIDER_INFOの typedef であることに注意してください。

RxCeConnectionInformation

クエリ 接続に関する情報を確認します。 成功すると、RXCE_CONNECTION_INFORMATION構造体が pInformation バッファーにコピーされます。 RXCE_CONNECTION_INFORMATIONは、TDI_CONNECTION_INFORMATIONの typedef であることに注意してください。

RxCeConnectionEndpointInformation

トランスポートに対してクエリを実行する 接続エンドポイントに関する情報を確認します。 成功すると、RXCE_CONNECTION_INFO構造体が pInformation バッファーにコピーされます。 RXCE_CONNECTION_INFOは、TDI_CONNECTION_INFOの typedef であることに注意してください。

RxCeRemoteAddressInformation

トランスポートに対してクエリを実行する リモート アドレスに関する情報を確認します。 成功すると、TDI_ADDRESS_INFO構造体が pInformation バッファーにコピーされます。

[out] pInformation

情報を返す呼び出し元から提供されるバッファー。

[in] Length

バッファーの長さ。

戻り値

RxCeQueryInformation は、成功した場合にSTATUS_SUCCESS、または次のいずれかの警告またはエラー コードを返します。

リターン コード 説明
STATUS_BUFFER_OVERFLOW
 pInformation が指す出力バッファーのこの指定された長さは、InformationClass クエリの種類によって要求された情報を受信するのに十分な大きさではありません。
STATUS_INSUFFICIENT_RESOURCES
 このルーチンで必要な非ページ プール メモリの割り当てに失敗しました。
STATUS_INVALID_PARAMETER
 この値は、次のいずれかの条件で返すことができます。
このルーチンに渡された pVC パラメーターが無効です。
この仮想回線に対して定義されている接続、アドレス、またはトランスポートが無効でした。
このクエリの種類の InformationClass は、許可された値の 1 つではありません。

注釈

RxCeQueryInformation は、特定の仮想回線の情報を返します。 RxCeQueryInformation を呼び出すときに指定できる InformationClass の値は次のとおりです。

RxCeTransportProviderInformation

RxCeConnectionInformation

RxCeConnectionEndpointInformation

RxCeRemoteAddressInformation

InformationClass の値によっては、RxCeQueryInformation によって TdiBuildQueryInformation と TDI が呼び出され、要求された情報が取得されます。

要件

要件 値
対象プラットフォーム デスクトップ
Header rxce.h (Rxce.h、Rxcehdlr.h、Tdi.h を含む)
IRQL <= APC_LEVEL

こちらもご覧ください

RxCeQueryAdapterStatus

RxCeQueryTransportInformation