RxCeQueryAdapterStatus 関数 (rxce.h)

RxCeQueryAdapterStatus は、呼び出し元割り当てバッファー内の特定のトランスポートのADAPTER_STATUS構造体を返します。

構文

NTSTATUS RxCeQueryAdapterStatus(
  PRXCE_TRANSPORT pTransport,
  _ADAPTER_STATUS *pAdapterStatus
);

pTransport

アダプターに関連付けられている RDBSS トランスポートへのポインター。

pAdapterStatus

入力時に、このパラメーターには、アダプターの状態を保持するための呼び出し元によって割り当てられたバッファーへのポインターが含まれます。この呼び出しが成功した場合の出力では、バッファーには、指定された RDBSS トランスポートに関連付けられているアダプターの状態が含まれます。

RxCeQueryAdapterStatus は、成功した場合はSTATUS_SUCCESS、失敗した場合は次のいずれかのエラーコードを返します。

リターンコード	説明
STATUS_ADDRESS_NOT_ASSOCIATED	アダプターアドレスが RDBSS トランスポートに関連付けられていない。
STATUS_INSUFFICIENT_RESOURCES	このルーチンで必要な非ページプールメモリの割り当てが失敗しました。
STATUS_INVALID_PARAMETER	このルーチンに渡された pTransport パラメーターが無効です。

RxCeQueryAdapterStatus は、特定のトランスポートのADAPTER_STATUS構造体を返します。このルーチンは、アダプターの NetBIOS 名を取得するために最も一般的に使用されます。

RxCeQueryAdapterStatus は、TDI_QUERY_ADAPTER_STATUS クエリを使用して TdiBuildQueryInformation を呼び出します。