Share via

Функция 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 вызывает TdiBuildQueryInformation с TDI_QUERY_ADAPTER_STATUS запросом.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть rxce.h (включая Rxce.h)
IRQL <= APC_LEVEL

См. также раздел

ADAPTER_STATUS

RxCeQueryInformation

RxCeQueryTransportInformation