Establecer parámetros de Device-Specific

Se espera que la mayoría de los dispositivos NDIS remotos funcionen bien sin necesidad de configurar parámetros en el host. Sin embargo, puede haber casos en los que una operación de red adecuada requiera alguna configuración en el host. Si el dispositivo admite parámetros configurables, debe incluir el siguiente OID opcional en la lista de identificadores operativos admitidos que notifica en respuesta a una consulta para OID_GEN_SUPPORTED_LIST:

#define OID_GEN_RNDIS_CONFIG_PARAMETER 0x0001021B

Si el dispositivo admite el OID de OID_GEN_RNDIS_CONFIG_PARAMETER , el host lo usa para establecer parámetros específicos del dispositivo, poco después de que el dispositivo entre en un estado inicializado por Remote NDIS desde el estado no inicializado. El host enviará cero o más REMOTE_NDIS_SET_MSGs al dispositivo, con OID_GEN_RNDIS_CONFIG_PARAMETER como valor de OID que se va a establecer. Cada uno de estos REMOTE_NDIS_SET_MSG corresponde a un parámetro específico del dispositivo configurado en el host.

InformationBuffer asociado a cada uno de estos REMOTE_NDIS_SET_MSG tiene el formato siguiente. Tenga en cuenta que los valores offset son relativos al principio del búfer de información.

Offset	Size	Campo	Descripción
0	4	ParameterNameOffset	Especifica el desplazamiento de bytes desde el principio del campo ParameterNameOffset en el que se encuentra una cadena de caracteres Unicode que representa el nombre del parámetro. La cadena no incluye un terminador NULL.
4	4	ParameterNameLength	Especifica la longitud de bytes de la cadena de nombre de parámetro.
8	4	ParameterType	Especifica el tipo de datos del valor del parámetro. Este es uno de los siguientes: 0 - valor numérico; 2 - valor de cadena.
12	4	ParameterValueOffset	Especifica el desplazamiento de bytes desde el principio del campo ParameterNameOffset en el que se encuentra el valor del parámetro.
16	4	ParameterValueLength	Especifica la longitud de bytes del valor del parámetro.

El dispositivo envía un REMOTE_NDIS_SET_CMPLT en respuesta a cada REMOTE_NDIS_SET_MSG, después de aplicar el valor del parámetro. Si la configuración del parámetro es aceptable, devuelve un estado de RNDIS_STATUS_SUCCESS en la respuesta. Si la configuración del parámetro no es aceptable y el dispositivo no puede aplicar un valor predeterminado útil para este parámetro, el dispositivo devuelve un valor de estado de error adecuado (consulte la sección sobre los valores de estado). Si se devuelve un estado de error, el host iniciará un proceso de detención para el dispositivo.

Se espera que los parámetros específicos del dispositivo se configuren en el Registro de Windows. Las claves que definen los valores de parámetro se crean normalmente en el Registro durante el proceso de instalación del dispositivo. La lista de claves, la información de tipo, los valores predeterminados y el intervalo opcional de valores válidos se especifican en el archivo INF para el dispositivo. Para obtener más información sobre cómo usar un INF para configurar parámetros de configuración en el Registro para dispositivos de red, consulte el Kit de desarrollo de controladores (DDK) de Windows 2000.