RxCeQueryAdapterStatus function
RxCeQueryAdapterStatus returns the ADAPTER_STATUS structure for a given transport in a caller-allocated buffer.
Syntax
NTSTATUS RxCeQueryAdapterStatus(
PRXCE_TRANSPORT pTransport,
struct _ADAPTER_STATUS *pAdapterStatus
);
Parameters
- pTransport
-
A pointer to the RDBSS transport that is associated with an adapter.
- pAdapterStatus
-
On input, this parameter contains a pointer to caller-allocated buffer to hold the adapter status. On output when this call is successful, the buffer contains the adapter status associated with the specified RDBSS transport.
Return value
RxCeQueryAdapterStatus returns STATUS_SUCCESS on success or one of the following error codes on failure:
| Return code | Description |
|---|---|
|
An adapter address is not associated with the RDBSS transport. |
|
The allocation of nonpaged pool memory needed by this routine failed. |
|
The pTransport parameter passed to this routine was invalid. |
Remarks
RxCeQueryAdapterStatus returns an ADAPTER_STATUS structure for a given transport. This routine is most commonly used to get the NetBIOS name of the adapter.
RxCeQueryAdapterStatus calls TdiBuildQueryInformation with a TDI_QUERY_ADAPTER_STATUS query.
Requirements
|
Header |
|
|---|---|
|
IRQL | <= APC_LEVEL |
See also
Send comments about this topic to Microsoft
Build date: 11/21/2012
