Partager via


Fonction RxCeQueryAdapterStatus (rxce.h)

RxCeQueryAdapterStatus retourne la structure ADAPTER_STATUS pour un transport donné dans une mémoire tampon allouée à l’appelant.

Syntaxe

NTSTATUS RxCeQueryAdapterStatus(
  PRXCE_TRANSPORT pTransport,
  _ADAPTER_STATUS *pAdapterStatus
);

Paramètres

pTransport

Pointeur vers le transport RDBSS associé à une carte.

pAdapterStatus

En entrée, ce paramètre contient un pointeur vers la mémoire tampon allouée à l’appelant pour contenir l’adaptateur status. Lorsque cet appel réussit, la mémoire tampon contient l’adaptateur status associé au transport RDBSS spécifié.

Valeur retournée

RxCeQueryAdapterStatus retourne STATUS_SUCCESS en cas de réussite ou l’un des codes d’erreur suivants en cas d’échec :

Code de retour Description
STATUS_ADDRESS_NOT_ASSOCIATED
Une adresse d’adaptateur n’est pas associée au transport RDBSS.
STATUS_INSUFFICIENT_RESOURCES
L’allocation de la mémoire de pool non paginé nécessaire à cette routine a échoué.
STATUS_INVALID_PARAMETER
Le paramètre pTransport passé à cette routine n’était pas valide.

Remarques

RxCeQueryAdapterStatus retourne une structure ADAPTER_STATUS pour un transport donné. Cette routine est la plus couramment utilisée pour obtenir le nom NetBIOS de l’adaptateur.

RxCeQueryAdapterStatus appelle TdiBuildQueryInformation avec une requête TDI_QUERY_ADAPTER_STATUS.

Configuration requise

Condition requise Valeur
Plateforme cible Desktop (Expérience utilisateur)
En-tête rxce.h (inclure Rxce.h)
IRQL <= APC_LEVEL

Voir aussi

ADAPTER_STATUS

RxCeQueryInformation

RxCeQueryTransportInformation