DXGKDDI_MONITORDESCRIPTORSET_ACQUIREFIRSTDESCRIPTORINFO fonction de rappel (d3dkmddi.h)

La fonction pfnAcquireFirstDescriptorInfo retourne le premier descripteur dans un objet de jeu de descripteur de moniteur.

Syntaxe

DXGKDDI_MONITORDESCRIPTORSET_ACQUIREFIRSTDESCRIPTORINFO DxgkddiMonitordescriptorsetAcquirefirstdescriptorinfo;

NTSTATUS DxgkddiMonitordescriptorsetAcquirefirstdescriptorinfo(
  [in]  IN_CONST_D3DKMDT_HMONITORDESCRIPTORSET hMonitorDescriptorSet,
  [out] DEREF_OUT_CONST_PPD3DKMDT_MONITOR_DESCRIPTOR ppFirstMonitorDescriptorInfo
)
{...}

Paramètres

[in] hMonitorDescriptorSet

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

[out] ppFirstMonitorDescriptorInfo

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

Valeur de retour

La fonction pfnAcquireFirstDescriptorInfo retourne l’une des valeurs suivantes.

Retourner le code	Description
STATUS_SUCCESS	La fonction a correctement retourné le premier descripteur dans l’ensemble.
STATUS_GRAPHICS_DATASET_IS_EMPTY	La fonction a réussi, mais il n’y avait pas de descripteurs dans l’ensemble.
STATUS_INVALID_PARAMETER	Un paramètre non valide a été fourni.
STATUS_GRAPHICS_INVALID_MONITOR_DESCRIPTORSET	Le handle fourni dans hMonitorDescriptorSet n’était pas valide.

Remarques

Lorsque 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 dans un descripteur de moniteur défini en appelant pfnAcquireFirstDescriptorInfo, puis en effectuant une séquence d’appels à pfnAcquireNextDescriptorInfo.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista
plateforme cible	Bureau
d’en-tête	d3dkmddi.h (include D3dkmddi.h)
IRQL	PASSIVE_LEVEL