DXGKDDI_EXCHANGEPRESTARTINFO fonction de rappel (dispmprt.h)

Permet l’échange de données très simples entre le système d’exploitation et le pilote, qui peuvent être nécessaires avant l’appel du périphérique DxgkDdiStartDevice et ne peuvent donc pas être interrogées via des majuscules normales ou des DDIs d’informations sur l’adaptateur.

Syntaxe

DXGKDDI_EXCHANGEPRESTARTINFO DxgkddiExchangeprestartinfo;

NTSTATUS DxgkddiExchangeprestartinfo(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_OUT_PDXGK_PRE_START_INFO pPreStartInfo
)
{...}

Paramètres

[in] hAdapter

Identifie l’adaptateur.

[in] pPreStartInfo

Pointeur vers une structure de DXGK_PRE_START_INFO , qui contient à la fois des champs pour que le système d’exploitation passe des informations et des champs pour que le pilote retourne des informations. Au départ, seul SupportPreserveBootDisplay est défini.

[out] SupportPreserveBootDisplay

Le pilote et le matériel prennent en charge les exigences qui permettent l’utilisation et l’affichage de la mémoire tampon de trame de démarrage tout au long de l’initialisation matérielle, effectuée pendant DxgkDdiStartDevice.

Valeur retournée

Si cette routine réussit et retourne la modification demandée, elle retourne STATUS_SUCCESS.

Remarques

Cette DDI sera appelée après DxgkDdiAddDevice et avant DxgkDdiStartDevice afin que le pilote n’ait pas accès à ses propres ressources matérielles. Toutefois, elle peut utiliser l’objet PhysicalDeviceObject passé au pilote dans DxgkDdiAddDevice pour appeler IoGetDeviceProperty. Par exemple, il peut trouver l’ID matériel afin de décider ce qu’il faut retourner dans les champs de sortie de la structure DXGK_PRE_START_INFO.

Cette fonction étant toujours appelée au niveau PASSIF, le code de prise en charge doit être rendu paginable dans la mesure du possible.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête dispmprt.h