SES_DOWNLOAD_MICROCODE_CONTROL_DIAGNOSTIC_PAGE structure (minitape.h)
La structure SES_DOWNLOAD_MICROCODE_CONTROL_DIAGNOSTIC_PAGE contient une image de microcode spécifique au fournisseur (c’est-à-dire un microprogramme) à utiliser par le processus des services de boîtier.
Syntaxe
typedef struct _SES_DOWNLOAD_MICROCODE_CONTROL_DIAGNOSTIC_PAGE {
UCHAR PageCode;
UCHAR SubEnclosureId;
UCHAR PageLength[2];
UCHAR ExpectedGenerationCode[4];
UCHAR Mode;
UCHAR Reserved[2];
UCHAR BufferID;
UCHAR BufferOffset[4];
UCHAR ImageLength[4];
UCHAR DataLength[4];
UCHAR Data[ANYSIZE_ARRAY];
} SES_DOWNLOAD_MICROCODE_CONTROL_DIAGNOSTIC_PAGE, *PSES_DOWNLOAD_MICROCODE_CONTROL_DIAGNOSTIC_PAGE;
Membres
PageCode
Spécifie la page de diagnostic envoyée ou demandée en fonction de la valeur. Pour une page de diagnostic de contrôle de microcode, la valeur doit être 0x0E.
SubEnclosureId
Spécifie le sous-boîtier auquel le client d’application envoie l’image de microcode. Si la valeur ne correspond pas à une valeur de champ SUBENCLOSURE_IDENTIFIER valide trouvée dans le SES_CONFIGURATION_DIAGNOSTIC_PAGE, le processus des services de boîtier abandonne l’opération de téléchargement du microcode avec une status de 0x80.
PageLength[2]
Spécifie le nombre d’octets qui suivent dans la page de diagnostic.
ExpectedGenerationCode[4]
Spécifie la valeur attendue du code de génération. Si ce paramètre n’est pas défini sur le code de génération actuel, le processus des services de boîtier abandonne l’opération de téléchargement du microcode avec une status de 0x80.
Mode
Spécifie le mode avec lequel télécharger le microcode.
| Valeur | Signification |
|---|---|
|
Une fois que la dernière commande SEND DIAGNOSTIC a remis une page de diagnostic Télécharger le contrôle de microcode à la sous-fermeture terminée, le processus des services de boîtier doit vérifier l’image de microcode complète (par exemple, effectuer une somme de contrôle spécifique au fournisseur) et enregistrer la nouvelle image de microcode dans un stockage non volatile.
S’il n’y a aucune erreur dans l’image de microcode ou dans l’opération d’enregistrement, le processus des services de boîtier doit effectuer l’une des actions suivantes :
|
|
Une fois la dernière commande SEND DIAGNOSTIC fournissant une SES_DOWNLOAD_MICROCODE_CONTROL_DIAGNOSTIC_PAGE à la sous-fermeture terminée, le processus des services de boîtier doit vérifier l’image de microcode complète (par exemple, effectuer une somme de contrôle spécifique au fournisseur), enregistrer la nouvelle image de microcode dans un stockage non volatile (par exemple, flash ROM) et différer l’activation du nouveau microcode.
S’il n’y a aucune erreur dans l’image de microcode ou dans l’opération d’enregistrement, le processus des services de boîtier doit définir le champ État dans SES_DOWNLOAD_MICROCODE_STATUS_DESCRIPTOR sur 0x13 dans le SES_DOWNLOAD_MICROCODE_STATUS_DIAGNOSTIC_PAGE, si nécessaire, et activer le nouveau microcode après :
|
|
Une fois que la commande SEND DIAGNOSTIC spécifiant ce mode est terminée, le processus des services de boîtier active l’image de microcode différée, le cas échéant. |
|
Réservé à un usage ultérieur. |
Reserved[2]
Réservé à un usage ultérieur.
BufferID
Spécifie une mémoire tampon spécifique dans le processus des services de boîtier pour recevoir l’image de microcode. Le processus des services de boîtier affecte des codes d’ID de mémoire tampon spécifiques au fournisseur aux mémoires tampons (par exemple, l’image de microprogramme main peut être stockée dans la mémoire tampon 00h et une image de microprogramme de sauvegarde peut être stockée dans la mémoire tampon 01h). Le processus des services de boîtier doit prendre en charge une valeur d’ID de mémoire tampon de 00h. Si plusieurs mémoires tampons sont prises en charge, le processus des services de boîtier doit affecter des codes d’ID de mémoire tampon supplémentaires contiguëment, à compter de 01h. Si le processus des services de boîtier reçoit un code d’ID de mémoire tampon non pris en charge, il doit abandonner l’opération de téléchargement du microcode et définir le champ État dans SES_DOWNLOAD_MICROCODE_STATUS_DESCRIPTOR sur 0x80 dans la structure SES_DOWNLOAD_MICROCODE_STATUS_DIAGNOSTIC_PAGE .
BufferOffset[4]
Spécifie le décalage en octets dans la mémoire tampon dans laquelle les données de microcode sont écrites en multiples de quatre. Le processus des services de boîtier peut nécessiter une augmentation contiguë de ce champ dans les commandes SEND DIAGNOSTIC consécutives.
ImageLength[4]
spécifie le nombre total d’octets dans l’image de microcode que l’application a l’intention d’envoyer au BufferID spécifié.
DataLength[4]
Spécifie la longueur des données, en octets.
Data[ANYSIZE_ARRAY]
Contient une partie de l’image de microcode spécifique au fournisseur.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Windows 10, version 1709 et versions ultérieures de Windows. |
| En-tête | minitape.h (inclure Minitape.h, Storport.h) |