Функция RxCeQueryAdapterStatus (rxce.h)
RxCeQueryAdapterStatus возвращает структуру ADAPTER_STATUS для заданного транспорта в буфере, выделенном вызывающим объектом.
Синтаксис
NTSTATUS RxCeQueryAdapterStatus(
PRXCE_TRANSPORT pTransport,
_ADAPTER_STATUS *pAdapterStatus
);
Параметры
pTransport
Указатель на транспорт RDBSS, связанный с адаптером.
pAdapterStatus
На входных данных этот параметр содержит указатель на буфер, выделенный вызывающим объектом, для хранения состояния адаптера. На выходе при успешном вызове буфер содержит состояние адаптера, связанное с указанным транспортом RDBSS.
Возвращаемое значение
RxCeQueryAdapterStatus возвращает STATUS_SUCCESS при успешном выполнении или один из следующих кодов ошибок при сбое:
| Код возврата | Описание |
|---|---|
|
Адрес адаптера не связан с транспортом RDBSS. |
|
Произошел сбой выделения памяти невыгрегированного пула, необходимой этой подпрограмме. |
|
Параметр pTransport , переданный в эту подпрограмму, был недопустимым. |
Комментарии
RxCeQueryAdapterStatus возвращает структуру ADAPTER_STATUS для заданного транспорта. Эта подпрограмма чаще всего используется для получения netBIOS-имени адаптера.
RxCeQueryAdapterStatus вызывает TdiBuildQueryInformation с TDI_QUERY_ADAPTER_STATUS запросом.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Персональный компьютер |
| Верхняя часть | rxce.h (включая Rxce.h) |
| IRQL | <= APC_LEVEL |