DXGKDDI_EXCHANGEPRESTARTINFO fonction de rappel (dispmprt.h)

Permet d’échanger des données très simples entre le système d’exploitation et le pilote, qui peuvent être requises avant l’appel de l’appareil DxgkDdiStartDevice et ne peut donc pas être interrogée par le biais de majuscules normales ou 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 DXGK_PRE_START_INFO, qui contient les deux champs pour que le système d’exploitation passe des informations et des champs pour que le pilote retourne des informations. Initialement, seul SupportPreserveBootDisplay est défini.

[out] SupportPreserveBootDisplay

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

Valeur de retour

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, il peut utiliser le PhysicalDeviceObject passé au pilote dans DxgkDdiAddDevice pour appeler IoGetDeviceProperty. Par exemple, il peut trouver l’ID matériel pour déterminer ce qu’il faut retourner dans les champs de sortie de la structure DXGK_PRE_START_INFO.

Cette fonction est toujours appelée au niveau passif afin que le code de prise en charge soit rendu paginable dans la mesure du possible.

Exigences

Exigence	Valeur
plateforme cible	Windows
d’en-tête	dispmprt.h