Função RxCeQueryAdapterStatus (rxce.h)

Artigo
02/27/2024

RxCeQueryAdapterStatus retorna a estrutura ADAPTER_STATUS para um determinado transporte em um buffer alocado pelo chamador.

Sintaxe

NTSTATUS RxCeQueryAdapterStatus(
  PRXCE_TRANSPORT pTransport,
  _ADAPTER_STATUS *pAdapterStatus
);

Parâmetros

pTransport

Um ponteiro para o transporte RDBSS associado a um adaptador.

pAdapterStatus

Na entrada, esse parâmetro contém um ponteiro para o buffer alocado pelo chamador para manter o adaptador status. Na saída quando essa chamada for bem-sucedida, o buffer conterá o adaptador status associado ao transporte RDBSS especificado.

Retornar valor

RxCeQueryAdapterStatus retorna STATUS_SUCCESS com êxito ou um dos seguintes códigos de erro em caso de falha:

Código de retorno	Descrição
STATUS_ADDRESS_NOT_ASSOCIATED	Um endereço do adaptador não está associado ao transporte RDBSS.
STATUS_INSUFFICIENT_RESOURCES	Falha na alocação de memória de pool nãopagado necessária para essa rotina.
STATUS_INVALID_PARAMETER	O parâmetro pTransport passado para essa rotina era inválido.

Comentários

RxCeQueryAdapterStatus retorna uma estrutura ADAPTER_STATUS para um determinado transporte. Essa rotina é mais comumente usada para obter o nome NetBIOS do adaptador.

RxCeQueryAdapterStatus chama TdiBuildQueryInformation com uma consulta TDI_QUERY_ADAPTER_STATUS.