structure IMAGE_INFO (ntddk.h)
La structure IMAGE_INFO est utilisée par la routine d’image de charge (PLOAD_IMAGE_NOTIFY_ROUTINE) du pilote pour spécifier les informations de chargement de l’image.
Syntaxe
typedef struct _IMAGE_INFO {
union {
ULONG Properties;
struct {
ULONG ImageAddressingMode : 8;
ULONG SystemModeImage : 1;
ULONG ImageMappedToAllPids : 1;
ULONG ExtendedInfoPresent : 1;
ULONG MachineTypeMismatch : 1;
ULONG ImageSignatureLevel : 4;
ULONG ImageSignatureType : 3;
ULONG ImagePartialMap : 1;
ULONG Reserved : 12;
};
};
PVOID ImageBase;
ULONG ImageSelector;
SIZE_T ImageSize;
ULONG ImageSectionNumber;
} IMAGE_INFO, *PIMAGE_INFO;
Membres
Properties
Représente toutes les valeurs de bits au sein de la structure avec laquelle Properties est associé.
ImageAddressingMode
Toujours défini sur IMAGE_ADDRESSING_MODE_32BIT.
SystemModeImage
Définissez soit sur un pour les composants en mode noyau nouvellement chargés, tels que les pilotes, soit sur zéro pour les images qui sont mappées dans l’espace utilisateur.
ImageMappedToAllPids
Toujours défini sur zéro.
ExtendedInfoPresent
Si l’indicateur ExtendedInfoPresent est défini, IMAGE_INFO fait partie de IMAGE_INFO_EX. Ajouté dans Windows Vista.
MachineTypeMismatch
Toujours défini sur zéro. Ajout dans Windows 8/Windows Server 2012.
ImageSignatureLevel
Niveau de signature avec lequel l’intégrité du code a étiqueté l’image. Cette valeur est l’une #define SE_SIGNING_LEVEL_* des constantes dans ntddk.h. Ajouté dans Windows 8.1/Windows Server 2012 R2.
ImageSignatureType
Type de signature avec lequel l’intégrité du code a étiqueté l’image. Cette valeur est une valeur d’énumération SE_IMAGE_SIGNATURE_TYPE , définie dans ntddk.h. Ajouté dans Windows 8.1/Windows Server 2012 R2.
ImagePartialMap
Cette valeur est différente de zéro si la vue de mappage d’image appelée pour est une vue partielle qui ne mappe pas l’image entière ; 0 si la vue mappe l’image entière. Ajouté dans Windows 10/Windows Server 2016.
Reserved
Toujours défini sur zéro.
ImageBase
Définissez sur l’adresse de base virtuelle de l’image.
ImageSelector
Toujours défini sur zéro.
ImageSize
Définissez sur la taille virtuelle, en octets, de l’image.
ImageSectionNumber
Toujours défini sur zéro.
Remarques
Si l’indicateur ExtendedInfoPresent est défini, la structure IMAGE_INFO fait partie de IMAGE_INFO_EX, qui est une version étendue et plus grande de la structure d’informations d’image. Dans ce cas, la routine de notification d’image de charge peut utiliser la macro CONTAINING_RECORD (dans miniport.h) pour obtenir l’adresse de base de la structure IMAGE_INFO_EX.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | ntddk.h (incluez Ntddk.h) |