DXGKDDI_MONITORDESCRIPTORSET_ACQUIREFIRSTDESCRIPTORINFO función de devolución de llamada (d3dkmddi.h)
La función pfnAcquireFirstDescriptorInfo devuelve el primer descriptor en un objeto de conjunto de descriptores de monitor.
Sintaxis
DXGKDDI_MONITORDESCRIPTORSET_ACQUIREFIRSTDESCRIPTORINFO DxgkddiMonitordescriptorsetAcquirefirstdescriptorinfo;
NTSTATUS DxgkddiMonitordescriptorsetAcquirefirstdescriptorinfo(
[in] IN_CONST_D3DKMDT_HMONITORDESCRIPTORSET hMonitorDescriptorSet,
[out] DEREF_OUT_CONST_PPD3DKMDT_MONITOR_DESCRIPTOR ppFirstMonitorDescriptorInfo
)
{...}
Parámetros
[in] hMonitorDescriptorSet
Identificador de un objeto de conjunto de descriptores de supervisión. El controlador de miniporte de pantalla obtuvo anteriormente este identificador llamando a la función pfnGetMonitorDescriptorSet de la interfaz Monitor.
[out] ppFirstMonitorDescriptorInfo
Puntero a una variable que recibe un puntero a una estructura D3DKMDT_MONITOR_DESCRIPTOR . La estructura es el primer descriptor del conjunto.
Valor devuelto
La función pfnAcquireFirstDescriptorInfo devuelve uno de los siguientes valores.
| Código devuelto | Descripción |
|---|---|
| STATUS_SUCCESS | La función devolvió correctamente el primer descriptor del conjunto. |
| STATUS_GRAPHICS_DATASET_IS_EMPTY | La función se realizó correctamente, pero no había ningún descriptor en el conjunto. |
| STATUS_INVALID_PARAMETER | Se proporcionó un parámetro no válido. |
| STATUS_GRAPHICS_INVALID_MONITOR_DESCRIPTORSET | El identificador proporcionado en hMonitorDescriptorSet no era válido. |
Comentarios
Cuando haya terminado de usar la estructura D3DKMDT_MONITOR_DESCRIPTOR, debe liberar la estructura llamando a pfnReleaseDescriptorInfo.
Puede obtener todos los descriptores de un conjunto de descriptores de supervisión llamando a pfnAcquireFirstDescriptorInfo y, a continuación, realizando una secuencia de llamadas a pfnAcquireNextDescriptorInfo.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Plataforma de destino | Escritorio |
| Encabezado | d3dkmddi.h (incluye D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |