Función NdisOpenProtocolConfiguration (ndis.h)
Nota NDIS 5. x ha quedado en desuso y se sustituye por NDIS 6. x. Para el nuevo desarrollo de controladores NDIS, consulte Controladores de red a partir de Windows Vista. Para obtener información sobre cómo migrar NDIS 5. x controladores a NDIS 6. x, consulte Migración de controladores NDIS 5.x a NDIS 6.0.
NdisOpenProtocolConfiguration devuelve un identificador para la clave del Registro en la que se almacena la información por adaptador de un controlador de protocolo.
Sintaxis
void NdisOpenProtocolConfiguration(
[out] PNDIS_STATUS Status,
[out] PNDIS_HANDLE ConfigurationHandle,
[in] PCNDIS_STRING ProtocolSection
);
Parámetros
[out] Status
Puntero a una variable proporcionada por el autor de la llamada que se establece en NDIS_STATUS_SUCCESS o un estado de error en la devolución de esta función.
[out] ConfigurationHandle
Puntero a una variable proporcionada por el autor de la llamada en la que esta función devuelve el identificador a la clave del Registro para el controlador de miniport con nombre al que se enlazará el autor de la llamada más adelante. Las entradas de valor de esta clave contienen información específica del adaptador instalada por protocolo.
[in] ProtocolSection
Puntero a un tipo de NDIS_STRING proporcionado por el autor de la llamada que contiene una cadena contada, especificada en el juego de caracteres predeterminado del sistema. Esta cadena contada nombra el controlador NIC NDIS, de forma eficaz el adaptador, para el que se debe abrir la clave de parámetros por adaptador en la sección del protocolo del Registro. Para los protocolos de Windows 2000 y versiones posteriores, esta cadena contada contiene caracteres Unicode. Es decir, para Windows 2000 y versiones posteriores, NDIS define el tipo de NDIS_STRING como un tipo de UNICODE_STRING .
Este puntero es el parámetro de entrada SystemSpecific1 para la función ProtocolBindAdapter del autor de la llamada.
Valor devuelto
None
Observaciones
NdisOpenProtocolConfiguration devuelve un identificador que el autor de la llamada puede pasar posteriormente a Ndis.. Funciones de configuración para recuperar o almacenar información en el Registro.
Un controlador de protocolo llama a NdisOpenProtocolConfiguration para obtener un identificador de clave del Registro que se pasará posteriormente a otros Ndis. Funciones de configuración , como NdisRead/WriteConfiguration o NdisOpenConfigurationKeyByName/Index, si su archivo de instalación almacena información de configuración específica del adaptador en la sección de protocolo del Registro desde la que el protocolo configura sus enlaces.
Un protocolo puede llamar a NdisOpenConfigurationKeyByName o NdisOpenConfigurationKeyByIndex para abrir cualquier subclave de la clave del Registro para la que NdisOpenProtocolConfiguration devuelve el identificador.
Los protocolos de Windows 2000 y versiones posteriores llaman a rutinas de compatibilidad con el modo kernel para abrir sus propias claves del Registro específicas del protocolo. Para obtener más información sobre estas rutinas de soporte técnico, consulte el resumen de Kernel-Mode rutinas de soporte técnico y rutinas de soporte técnico de administración de energía.
- Plataforma de destino: Universal
- Versión: no se admite para controladores NDIS 6.0 en Windows Vista. En su lugar, use NdisOpenConfigurationEx. Compatible con controladores NDIS 5.1 en Windows Vista y Windows XP.
Requisitos
| Requisito | Valor |
|---|---|
| Header | ndis.h (incluya Ndis.h) |
| Library | Ndis.lib |
| IRQL | PASSIVE_LEVEL |