Función RxCeQueryAdapterStatus (rxce.h)

Artículo
08/07/2023

RxCeQueryAdapterStatus devuelve la estructura ADAPTER_STATUS para un transporte determinado en un búfer asignado por el autor de la llamada.

Sintaxis

NTSTATUS RxCeQueryAdapterStatus(
  PRXCE_TRANSPORT pTransport,
  _ADAPTER_STATUS *pAdapterStatus
);

Parámetros

pTransport

Puntero al transporte RDBSS asociado a un adaptador.

pAdapterStatus

En la entrada, este parámetro contiene un puntero al búfer asignado por el autor de la llamada para contener el estado del adaptador. Cuando esta llamada se realiza correctamente, el búfer contiene el estado del adaptador asociado al transporte RDBSS especificado.

Valor devuelto

RxCeQueryAdapterStatus devuelve STATUS_SUCCESS si se ejecuta correctamente o uno de los siguientes códigos de error en caso de error:

Código devuelto	Descripción
STATUS_ADDRESS_NOT_ASSOCIATED	Una dirección del adaptador no está asociada al transporte RDBSS.
STATUS_INSUFFICIENT_RESOURCES	Error en la asignación de memoria de grupo no paginada necesaria para esta rutina.
STATUS_INVALID_PARAMETER	El parámetro pTransport pasado a esta rutina no era válido.

Comentarios

RxCeQueryAdapterStatus devuelve una estructura ADAPTER_STATUS para un transporte determinado. Esta rutina se usa normalmente para obtener el nombre NetBIOS del adaptador.

RxCeQueryAdapterStatus llama a TdiBuildQueryInformation con una consulta TDI_QUERY_ADAPTER_STATUS.