Función IoGetDeviceInterfacePropertyData (wdm.h)
La rutina IoGetDeviceInterfacePropertyData recupera el valor actual de una propiedad de interfaz de dispositivo.
Sintaxis
NTSTATUS IoGetDeviceInterfacePropertyData(
[in] PUNICODE_STRING SymbolicLinkName,
[in] const DEVPROPKEY *PropertyKey,
[in] LCID Lcid,
ULONG Flags,
[in] ULONG Size,
[out] PVOID Data,
[out] PULONG RequiredSize,
[out] PDEVPROPTYPE Type
);
Parámetros
[in] SymbolicLinkName
Puntero a una cadena que identifica la instancia de la interfaz de dispositivo. Esta cadena se obtuvo de una llamada anterior a la rutina IoGetDeviceInterfaces, IoGetDeviceInterfaceAlias o IoRegisterDeviceInterface .
[in] PropertyKey
Puntero a una estructura DEVPROPKEY que contiene la clave de propiedad de la interfaz de dispositivo.
[in] Lcid
Especifica un identificador de configuración regional. Establezca este parámetro en un valor LCID específico del idioma o en LOCALE_NEUTRAL. El LOCALE_NEUTRAL LCID especifica que la propiedad es independiente del idioma (es decir, no específica de ningún idioma). No establezca este parámetro en LOCALE_SYSTEM_DEFAULT o LOCALE_USER_DEFAULT. Para obtener más información sobre los valores lcID específicos del lenguaje, vea LCID Structure.
Flags
Reservado para uso del sistema. Los controladores deben establecer este valor en cero.
[in] Size
Especifica el tamaño, en bytes, del búfer al que apunta Data .
[out] Data
Puntero a un búfer asignado por el autor de la llamada en el que la rutina escribe los datos de propiedad de la interfaz de dispositivo.
[out] RequiredSize
Puntero a una variable ULONG en la que IoGetDeviceInterfacePropertyData escribe el tamaño necesario de los datos de propiedad. Si la rutina se realiza correctamente, el valor de tamaño necesario es el número de bytes a los que escribe la rutina en el búfer de salida al que apunta Data . Si la rutina devuelve STATUS_BUFFER_TOO_SMALL, el valor de tamaño necesario es el tamaño del búfer que el autor de la llamada debe asignar para este valor de propiedad.
[out] Type
Puntero a una variable DEVPROPTYPE . Si IoGetDeviceInterfacePropertyData recupera correctamente los datos de propiedad, la rutina escribe el valor del tipo de propiedad en esta variable. Este valor indica el tipo de datos de propiedad que se encuentra en el búfer de datos .
Valor devuelto
IoGetDeviceInterfacePropertyData devuelve STATUS_SUCCESS si se realiza correctamente. Entre los posibles valores devueltos de error se incluyen los siguientes códigos de estado.
| Código devuelto | Descripción |
|---|---|
| STATUS_BUFFER_TOO_SMALL | El búfer al que apunta Data es demasiado pequeño para contener los datos de propiedad. *RequiredSize contiene la longitud de búfer necesaria. |
| STATUS_UNSUCCESSFUL | El valor LCID especificado no es válido. |
| STATUS_NOT_IMPLEMENTED | No se admite la propiedad especificada. |
Comentarios
Los controladores en modo kernel usan la rutina IoGetDeviceInterfacePropertyData para recuperar las propiedades de la interfaz de dispositivo definidas como parte del modelo de propiedades de dispositivo unificado. Para obtener más información sobre las propiedades de la interfaz de dispositivo, consulte Propiedades del dispositivo.
Los controladores pueden usar la rutina IoSetDeviceInterfacePropertyData para modificar una propiedad de interfaz de dispositivo.
Los autores de llamadas de IoGetDeviceInterfacePropertyData deben ejecutarse en IRQL = PASSIVE_LEVEL en el contexto de un subproceso del sistema.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows 8 y versiones posteriores de Windows. |
| Plataforma de destino | Universal |
| Encabezado | wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |