OID_GEN_SUPPORTED_GUIDS
Como consulta, el OID_GEN_SUPPORTED_GUIDS OID solicita al controlador de miniportar que devuelva una matriz de estructuras del tipo NDIS_GUID.
de información de versión de
Windows Vista y versiones posteriores de Windows
Soportado.
controladores de miniporte NDIS 6.0 y versiones posteriores
Opcional.
controladores de miniporte NDIS 5.1
Opcional.
controladores de miniporte NDIS 5.1
Opcional.
Observaciones
Cada estructura de la matriz especifica la asignación de un GUID personalizado (identificador único global) a un OID personalizado o a un NDIS_STATUS que el controlador de miniporte envía a través de la función NdisMIndicateStatusEx.
La estructura NDIS_GUID se define de la siguiente manera:
typedef struct _NDIS_GUID {
GUID Guid;
union {
NDIS_OID Oid;
NDIS_STATUS Status;
};
ULONG Size;
ULONG Flags;
} NDIS_GUID, *PNDIS_GUID;
Los miembros de esta estructura contienen la siguiente información:
guid de
Especifica el GUID personalizado definido para el controlador de miniport.
Oid
Especifica el OID personalizado al que se asigna Guid.
estado de
Especifica el NDIS_STATUS al que se asigna guid.
tamaño de
Especifica el tamaño en bytes de cada elemento de datos de la matriz devuelta por el controlador de miniport. Si se establece la marca fNDIS_GUID_ANSI_STRING o fNDIS_GUID_NDIS_STRING, Tamaño se establece en -1. De lo contrario, Tamaño especifica el tamaño en bytes del elemento de datos que representa el GUID. Este miembro solo se especifica cuando se establece la marca fNDIS_GUID_ARRAY.
marcas de
El operador OR puede combinar las marcas siguientes para indicar si el GUID se asigna a un OID o a una cadena de NDIS_STATUS y para indicar el tipo de datos proporcionado para el GUID:
fNDIS_GUID_TO_OID
Indica que la estructura NDIS_GUID asigna un GUID a un OID.
fNDIS_GUID_TO_STATUS
Indica que la estructura NDIS_GUID asigna un GUID a una cadena de NDIS_STATUS.
fNDIS_GUID_ANSI_STRING
Indica que se proporciona una cadena ANSI terminada en null para el GUID.
fNDIS_GUID_UNICODE_STRING
Indica que se proporciona una cadena Unicode para el GUID.
fNDIS_GUID_ARRAY
Indica que se proporciona una matriz de elementos de datos para el GUID. El Size especificado indica la longitud de cada elemento de datos de la matriz.
fNDIS_GUID_ALLOW_READ
Cuando se establece, indica que todos los usuarios pueden usar este GUID para obtener información.
fNDIS_GUID_ALLOW_WRITE
Cuando se establece, indica que todos los usuarios pueden usar este GUID para establecer información.
Nota De forma predeterminada, los GUID de WMI personalizados proporcionados por un controlador de miniport solo son accesibles para los usuarios con privilegios de administrador. Un usuario con privilegios de administrador siempre puede leer o escribir en un GUID personalizado si el controlador de miniporte admite la operación de lectura o escritura para ese GUID. Establezca las marcas fNDIS_GUID_ALLOW_READ y fNDIS_GUID_ALLOW_WRITE para permitir que todos los usuarios accedan a un GUID personalizado.
Tenga en cuenta que todos los GUID personalizados registrados por un controlador de miniport deben establecer fNDIS_GUID_TO_OID o fNDIS_GUID_TO_STATUS (nunca se establecen ambos). Todas las demás marcas se pueden combinar mediante el operador OR según corresponda.
En el ejemplo siguiente, una estructura de NDIS_GUID asigna un GUID a OID_802_3_MULTICAST_LIST:
NDIS_GUID NdisGuid = {{0x44795701, 0xa61b, 0x11d0, 0x8d, 0xd4,
0x00, 0xc0, 0x4f, 0xc3,
0x35, 0x8c},
OID_802_3_MULTICAST_LIST,
6,
fNDIS_GUID_TO_OID | fNDIS_GUID_ARRAY};
Un GUID es un identificador usado por Instrumental de administración de Windows (WMI) para obtener o establecer información. NDIS intercepta un GUID enviado por WMI a un controlador NDIS, asigna el GUID a un OID y envía el OID al controlador. El controlador devuelve los elementos de datos a NDIS, que después devuelve los datos a WMI.
NDIS también traduce los cambios en el estado de la NIC en GUID que WMI reconoce. Cuando un controlador de miniporte informa de un cambio en el estado de la NIC mediante la función de NdisMIndicateStatusEx, NDIS traduce la NDIS_STATUS indicada por el controlador de miniport en un GUID que NDIS envía a WMI.
Si un controlador de miniporte admite GUID aduaneros, debe admitir OID_GEN_SUPPORTED_GUIDS. Este OID vuelve a NDIS la asignación de GUID personalizados a OID personalizados o cadenas de NDIS_STATUS. Después de consultar el controlador de miniporte mediante OID_GEN_SUPPORTED_GUIDS, NDIS registra los GUID personalizados del controlador de miniport con WMI.
Requisitos
Encabezado |
Ntddndis.h (include Ndis.h) |