DXGKDDI_MONITOR_GETMONITORDESCRIPTORSET función de devolución de llamada (d3dkmddi.h)
La función pfnGetMonitorDescriptorSet devuelve un identificador a un objeto de conjunto de descriptores de supervisión asociado a un monitor especificado.
Sintaxis
DXGKDDI_MONITOR_GETMONITORDESCRIPTORSET DxgkddiMonitorGetmonitordescriptorset;
NTSTATUS DxgkddiMonitorGetmonitordescriptorset(
[in] IN_CONST_D3DKMDT_ADAPTER hAdapter,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VideoPresentTargetId,
[out] OUT_PD3DKMDT_HMONITORDESCRIPTORSET phMonitorDescriptorSet,
[out] DEREF_OUT_CONST_PPDXGK_MONITORDESCRIPTORSET_INTERFACE ppMonitorDescriptorSetInterface
)
{...}
Parámetros
[in] hAdapter
Identificador que identifica un adaptador de pantalla. Anteriormente, el subsistema del kernel de gráficos de Microsoft DirectX proporcionó este identificador al controlador de miniporte para mostrar en el parámetro DxgkInterface de la función DxgkDdiStartDevice.
[in] VideoPresentTargetId
Entero que identifica uno de los destinos presentes de vídeo en el adaptador de pantalla. El objeto de conjunto de descriptores de supervisión devuelto contiene descriptores para el monitor que está conectado a este destino de vídeo presente.
[out] phMonitorDescriptorSet
Puntero a una variable que recibe un identificador de un objeto de conjunto de descriptores de supervisión.
[out] ppMonitorDescriptorSetInterface
Puntero a una variable que recibe un puntero a una estructura DXGK_MONITORDESCRIPTORSET_INTERFACE. La estructura contiene punteros a funciones a las que el controlador de miniporte de pantalla puede llamar para inspeccionar y modificar el objeto del conjunto de descriptores de supervisión.
Valor devuelto
La función pfnGetMonitorDescriptorSet devuelve uno de los valores siguientes.
| Código devuelto | Descripción |
|---|---|
| STATUS_SUCCESS | La función se realizó correctamente. |
| STATUS_INVALID_PARAMETER | Se proporcionó un parámetro no válido. |
| STATUS_GRAPHICS_INVALID_DISPLAY_ADAPTER | El identificador proporcionado en hAdapter no era válido. |
| STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET | El identificador proporcionado en VideoPresentTargetId no era válido. |
| STATUS_GRAPHICS_MONITOR_NOT_CONNECTED | No hay ningún monitor conectado al destino de presentación de vídeo identificado por VideoPresentTargetId. |
Observaciones
El controlador de miniporte de pantalla asigna los identificadores de destino vidPN. La función dxgkDdiQueryChildRelations, implementada por el controlador de miniporte de pantalla, devuelve una matriz de estructuras de DXGK_CHILD_DESCRIPTOR, cada una de las cuales contiene un identificador.
No es necesario liberar el identificador devuelto en phMonitorDescriptorSet.
Esta función también está disponible en la interfaz DXGK_MONITOR_INTERFACE_V2 a partir de Windows 7.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows Vista |
| de la plataforma de destino de | Escritorio |
| encabezado de | d3dkmddi.h (incluya D3dkmddi.h) |
| irQL | PASSIVE_LEVEL |