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 呼び出して、要求された情報を取得します。

必要条件

要件 価値
ターゲット プラットフォーム デスクトップ
ヘッダー rxce.h (Rxce.h、Rxcehdlr.h、Tdi.h を含む)
IRQL <= APC_LEVEL

関連項目

RxCeQueryAdapterStatus

RxCeQueryTransportInformation