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を返します。
| リターン コード | 形容 |
|---|---|
|
pInformation 指す出力バッファーの 長さが、InformationClass クエリの種類によって要求された情報を受信するのに十分な大きさではなかった 指定しました。 |
|
このルーチンで必要な非ページ プール メモリの割り当てに失敗しました。 |
|
この値は、次のいずれかの条件で返すことができます。
|
備考
RxCeQueryInformation は、特定の仮想回線の情報を返します。 RxCeQueryInformation を呼び出すときに指定できる InformationClass の値は、次 だけです。
RxCeTransportProviderInformation
RxCeConnectionInformation
RxCeConnectionEndpointInformation
RxCeRemoteAddressInformation
InformationClassの一部の値については、RxCeQueryInformation 、TdiBuildQueryInformation と TDI 呼び出して、要求された情報を取得します。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | rxce.h (Rxce.h、Rxcehdlr.h、Tdi.h を含む) |
| IRQL | <= APC_LEVEL |
関連項目
RxCeQueryAdapterStatus の
RxCeQueryTransportInformation の