DXGKDDI_MONITORDESCRIPTORSET_ACQUIRENEXTDESCRIPTORINFO fonction de rappel (d3dkmddi.h)

  • Article

La fonction pfnAcquireNextDescriptorInfo retourne le descripteur suivant dans un jeu de descripteur de moniteur, compte tenu du descripteur actuel.

Syntaxe

DXGKDDI_MONITORDESCRIPTORSET_ACQUIRENEXTDESCRIPTORINFO DxgkddiMonitordescriptorsetAcquirenextdescriptorinfo;

NTSTATUS DxgkddiMonitordescriptorsetAcquirenextdescriptorinfo(
  [in]  IN_CONST_D3DKMDT_HMONITORDESCRIPTORSET hMonitorDescriptorSet,
  [in]  IN_CONST_PD3DKMDT_MONITOR_DESCRIPTOR_CONST pMonitorDescriptorInfo,
  [out] DEREF_OUT_CONST_PPD3DKMDT_MONITOR_DESCRIPTOR ppNextMonitorDescriptorInfo
)
{...}

Paramètres

[in] hMonitorDescriptorSet

Handle d’un objet set de descripteur de surveillance. Le pilote de miniport d’affichage a précédemment obtenu ce handle en appelant la fonction pfnGetMonitorDescriptorSet de l’interface Monitor.

[in] pMonitorDescriptorInfo

Pointeur vers une structure D3DKMDT_MONITOR_DESCRIPTOR qui est le descripteur actuel. Le pilote de miniport d’affichage a précédemment obtenu ce pointeur en appelant pfnAcquireFirstDescriptorInfo ou pfnAcquireNextDescriptorInfo.

[out] ppNextMonitorDescriptorInfo

Pointeur vers une variable qui reçoit un pointeur vers une structure D3DKMDT_MONITOR_DESCRIPTOR . La structure est le descripteur suivant dans l’ensemble.

Valeur retournée

La fonction pfnAcquireNextDescriptorInfo retourne l’une des valeurs suivantes.

Code de retour Description
STATUS_SUCCESS La fonction a correctement retourné le descripteur suivant dans l’ensemble.
STATUS_GRAPHICS_NO_MORE_ELEMENTS_IN_DATASET La fonction a réussi, mais il n’y avait plus de descripteurs dans l’ensemble.
STATUS_INVALID_PARAMETER Un paramètre non valide a été fourni.
STATUS_INVALID_MONITOR_DESCRIPTOR Le descripteur fourni dans pMonitorDescriptorInfo n’était pas valide.
STATUS_GRAPHICS_INVALID_MONITOR_DESCRIPTORSET Le handle fourni dans hMonitorDescriptorSet n’était pas valide.

Remarques

Une fois que vous avez terminé d’utiliser la structure D3DKMDT_MONITOR_DESCRIPTOR, vous devez libérer la structure en appelant pfnReleaseDescriptorInfo.

Vous pouvez obtenir tous les descripteurs d’un descripteur de surveillance défini en appelant pfnAcquireFirstDescriptorInfo , puis en effectuant une séquence d’appels à pfnAcquireNextDescriptorInfo.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista
Plateforme cible Desktop (Expérience utilisateur)
En-tête d3dkmddi.h (include D3dkmddi.h)
IRQL PASSIVE_LEVEL