Directiva DelProperty de INF
Precaución
Si va a crear un paquete de controladores universal o de Windows, esta directiva no es válida. Consulte Uso de un archivo INF universal e Introducción al desarrollo de controladores de Windows.
Una directiva DelProperty hace referencia a una o varias secciones de archivos INF que eliminan las propiedades del dispositivo para una instancia de dispositivo, una clase de configuración de dispositivo, una clase de interfaz de dispositivo o una interfaz de dispositivo.
[DDInstall] |
[DDInstall.CoInstallers] |
[ClassInstall32] |
[ClassInstall32.ntx86] |
[ClassInstall32.ntia64] | (Windows XP and later versions of Windows)
[ClassInstall32.ntamd64] | (Windows XP and later versions of Windows)
[ClassInstall32.ntarm] | (Windows 8 and later versions of Windows)
[ClassInstall32.ntarm64] | (Windows 10 version 1709 and later versions of Windows)
[interface-install-section] |
[interface-install-section.nt] |
[interface-install-section.ntx86] |
[interface-install-section.ntia64] | (Windows XP and later versions of Windows)
[interface-install-section.ntamd64] | (Windows XP and later versions of Windows)
[interface-install-section.ntarm] | (Windows 8 and later versions of Windows)
[interface-install-section.ntarm64] | (Windows 10 version 1709 and later versions of Windows)
[add-interface-section]
DelProperty=del-property-section[,del-property-section]... (Windows Vista and later versions of Windows)
Se puede especificar una directiva DelProperty en cualquiera de las secciones que se muestran en la instrucción de sintaxis formal anterior.
Una del-property-section a la que hace referencia una directiva DelProperty tiene el siguiente formato:
[del-property-section]
(property-name [ ,, flags [, value]]) | ({property-category-guid}, property-pid [ , flags [, value]])
(property-name [ ,, flags [, value]]) | ({property-category-guid}, property-pid [ , flags [, value]])
...
Una del-property-section puede tener cualquier número de entradas property-name o property-guid, cada una en una línea independiente.
Entries
property-name
Uno de los nombres de propiedad que representan las propiedades del paquete de controladores de instancia de dispositivo. Los nombres de propiedad admitidos son los mismos que los descritos para la entrada property-name de la directiva AddProperty del INF.
property-category-guid
Valor de GUID que identifica la categoría de propiedad. El valor de GUID puede ser un GUID definido por el sistema que identifica una categoría de propiedad definida por el sistema o un GUID personalizado que identifica una categoría de propiedad personalizada. Los valores de GUID admitidos son los mismos que los descritos para la entrada property-category-guid de la directiva AddProperty del INF.
property-pid
Identificador de propiedad que indica la propiedad específica dentro de la categoría de propiedad indicada por el valor de property-category-guid. Por motivos internos del sistema, un identificador de propiedad debe ser mayor o igual que dos.
flags
Valor de marca hexadecimal opcional que controla la operación de eliminación. El único valor de marca admitido es el siguiente:
0x00000001 (FLG_DELPROPERTY_MULTI_SZ_DELSTRING)
Si el tipo de datos de propiedad es DEVPROP_TYPE_STRING_LIST, la operación elimina todas las cadenas con la lista de cadenas existente que coinciden con la cadena proporcionada por el valor de entrada de valor. No se tienen en cuenta las mayúsculas o minúsculas de un carácter al comparar la cadena proporcionada y una cadena existente en la lista de cadenas.
value
Si el tipo de datos de propiedad es DEVPROP_TYPE_STRING_LIST y la entrada flags es 0x00000001, el valor de entrada de value proporciona la cadena que usa la operación de eliminación para buscar cadenas coincidentes en la lista de cadenas existentes y, si se encuentra una cadena coincidente, la operación de eliminación quita la cadena coincidente de la lista de cadenas existentes.
Comentarios
En general, un archivo INF no debe usarse para eliminar las propiedades del dispositivo que podría establecer un componente del sistema u otro archivo INF. El propósito principal de la directiva DelProperty es usarla en un archivo INF que actualiza una instalación de dispositivo anterior y ya no se requiere una propiedad establecida para una instalación de dispositivo anterior.
Un nombre de del-property-section debe ser único dentro de un archivo INF, pero se puede hacer referencia al nombre de sección en más de una directiva DelProperty en el mismo archivo INF. Un nombre de sección debe seguir las reglas generales para definir nombres de sección que se describen en Reglas de sintaxis general para archivos INF.
Para obtener más información sobre cómo usar la directiva DelProperty,consulte Uso de la directiva AddProperty de INF y la directiva DelProperty de INF.
Ejemplos
En el ejemplo siguiente de una sección de eliminación de propiedades se incluyen dos entradas de línea: la primera entrada de línea incluye un valor de entrada property-name que elimina la propiedad DeviceModel y la segunda entrada de línea elimina la cadena "DeleteThisString" de un valor de propiedad de dispositivo personalizado cuyo tipo de datos es DEVPROP_TYPE_STRING_LIST. En la segunda línea, el valor de entrada de property-category-guid es "c22189e4-8bf3-4e6d-8467-8dc6d95e2a7e", el valor de entrada de property-identifier es "2" y el valor de entrada de flags es "0x00000001",
[SampleDelPropertySection]
DeviceModel
{c22189e4-8bf3-4e6d-8467-8dc6d95e2a7e}, 2, 0x00000001, "DeleteThisString"