OID_GEN_SUPPORTED_GUIDS

Como consulta, el OID_GEN_SUPPORTED_GUIDS OID solicita al controlador de minipuerto que devuelva una matriz de estructuras del tipo NDIS_GUID.

Información de versión

Windows Vista y versiones posteriores de Windows
Compatible.

Controladores de miniporte NDIS 6.0 y versiones posteriores
Opcional.

Controladores de miniporte NDIS 5.1
Opcional.

Windows XP
Compatible.

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 una 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
Especifica el GUID personalizado definido para el controlador de miniport.

Oid
Especifica el OID personalizado al que se asigna guid .

Status
Especifica la NDIS_STATUS a la que se asigna guid .

Tamaño
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, Size se establece en -1. De lo contrario, Size 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.

Banderas
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 proporcionados para el GUID:

fNDIS_GUID_TO_OID
Indica que la estructura de NDIS_GUID asigna un GUID a un OID.

fNDIS_GUID_TO_STATUS
Indica que la estructura de 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 tamaño 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 minipuerto 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 minipuerto deben establecer fNDIS_GUID_TO_OID o fNDIS_GUID_TO_STATUS (nunca establecer 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 que usa 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 reconocidos por WMI. Cuando un controlador de minipuerto notifica un cambio en el estado de la NIC mediante la función NdisMIndicateStatusEx , NDIS traduce el NDIS_STATUS indicado por el controlador de minipuerto en un GUID que NDIS envía a WMI.

Si un controlador de minipuerto admite GUID aduaneros, debe admitir OID_GEN_SUPPORTED_GUIDS. Este OID vuelve a NDIS la asignación de GUID personalizados a identificadores OID personalizados o cadenas de NDIS_STATUS. Después de consultar el controlador de minipuerto mediante OID_GEN_SUPPORTED_GUIDS, NDIS registra los GUID personalizados del controlador de miniporte con WMI.

Requisitos

Encabezado

Ntddndis.h (include Ndis.h)

Consulte también

NdisMIndicateStatusEx