Функция RxCeQueryAdapterStatus (rxce.h)

2025-02-07

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.