DXGKDDI_MONITORDESCRIPTORSET_ACQUIRENEXTDESCRIPTORINFO fonction de rappel (d3dkmddi.h)
La fonction pfnAcquireNextDescriptorInfo retourne le descripteur suivant dans un jeu de descripteur de moniteur, en fonction 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 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.
[in] pMonitorDescriptorInfo
Pointeur vers une structure D3DKMDT_MONITOR_DESCRIPTOR qui est le descripteur actuel. Le pilote de miniport d’affichage a obtenu précédemment 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 de retour
La fonction pfnAcquireNextDescriptorInfo retourne l’une des valeurs suivantes.
| Retourner le code | 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
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 |