Funzione RxCeQueryAdapterStatus (rxce.h)

Articolo
02/07/2025

RxCeQueryAdapterStatus restituisce la struttura ADAPTER_STATUS per un determinato trasporto in un buffer allocato dal chiamante.

Sintassi

NTSTATUS RxCeQueryAdapterStatus(
  PRXCE_TRANSPORT pTransport,
  _ADAPTER_STATUS *pAdapterStatus
);

Parametri

pTransport

Puntatore al trasporto RDBSS associato a un adattatore.

pAdapterStatus

In caso di input, questo parametro contiene un puntatore al buffer allocato dal chiamante per contenere lo stato dell'adattatore. In caso di esito positivo della chiamata, il buffer contiene lo stato dell'adattatore associato al trasporto RDBSS specificato.

Valore restituito

RxCeQueryAdapterStatus restituisce STATUS_SUCCESS in caso di esito positivo o uno dei codici di errore seguenti in caso di errore:

Codice restituito	Descrizione
STATUS_ADDRESS_NOT_ASSOCIATED	Un indirizzo dell'adattatore non è associato al trasporto RDBSS.
STATUS_INSUFFICIENT_RESOURCES	L'allocazione della memoria del pool non di paging necessaria per questa routine non è riuscita.
STATUS_INVALID_PARAMETER	Il parametro pTransport passato a questa routine non è valido.

Osservazioni

RxCeQueryAdapterStatus restituisce una struttura ADAPTER_STATUS per un determinato trasporto. Questa routine viene usata più comunemente per ottenere il nome NetBIOS dell'adapter.

RxCeQueryAdapterStatus chiama TdiBuildQueryInformation con una query TDI_QUERY_ADAPTER_STATUS.