DXGKDDI_MONITORDESCRIPTORSET_ACQUIREFIRSTDESCRIPTORINFO fonction de rappel (d3dkmddi.h)
La fonction pfnAcquireFirstDescriptorInfo retourne le premier descripteur dans un objet set 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 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.
[out] ppFirstMonitorDescriptorInfo
Pointeur vers une variable qui reçoit un pointeur vers une structure D3DKMDT_MONITOR_DESCRIPTOR . La structure est le premier descripteur de l’ensemble.
Valeur retournée
La fonction pfnAcquireFirstDescriptorInfo retourne l’une des valeurs suivantes.
Code de retour | Description |
---|---|
STATUS_SUCCESS | La fonction a correctement retourné le premier descripteur de l’ensemble. |
STATUS_GRAPHICS_DATASET_IS_EMPTY | La fonction a réussi, mais il n’y avait aucun descripteur 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
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 |