DXGKDDI_PRESENTDISPLAYONLY función de devolución de llamada (d3dkmddi.h)
Presenta la imagen de pantalla al dispositivo para mostrar de un controlador de solo visualización en modo kernel (KMDOD).
Sintaxis
DXGKDDI_PRESENTDISPLAYONLY DxgkddiPresentdisplayonly;
NTSTATUS DxgkddiPresentdisplayonly(
IN_CONST_HANDLE hAdapter,
IN_CONST_PDXGKARG_PRESENT_DISPLAYONLY pPresentDisplayOnly
)
{...}
Parámetros
hAdapter
Identificador del contexto del dispositivo para el adaptador de pantalla. La función DxgkDdiAddDevice de KMDOD devolvió previamente este identificador en el parámetro miniportDeviceContext de.
pPresentDisplayOnly
Puntero a una estructura DXGKARG_PRESENT_DISPLAYONLY que contiene información sobre la operación actual.
Valor devuelto
Devuelve uno de los siguientes valores:
| código de retorno | descripción |
|---|---|
| STATUS_SUCCESS | La operación actual se completó correctamente. |
| STATUS_PENDING | La operación actual se ha enviado a la cola de software o hardware para completarse. En este caso, el KMDOD debe usar una llamada de procedimiento diferido y de interrupción (DPC) para notificar el progreso de la operación actual actual. De lo contrario, el sistema operativo usa el proceso de detección y recuperación de tiempo de espera (TDR), que notifica un error y requiere que el KMDOD se reinicialice y restablezca la GPU. Tenga en cuenta que este código de estado no debe devolverse para el modo sincrónico, como se describe en Comentarios. |
El controlador también puede devolver cualquier otro código de estado de error definido en Ntstatus.h para indicar problemas que se han producido con la operación actual.
Observaciones
El KMDOD debe completar todos los movimientos de pantalla a pantalla antes de copiar rectángulos sucios. Además, el KMDOD debe completar cada operación de movimiento o copia antes de iniciar otra operación de movimiento o copia.
El sistema operativo admite dos modos de operaciones presentes de KMDOD: sincrónicas y asincrónicas. En función de la implementación del hardware y del controlador, el KMDOD puede usar el modo o cambiar entre ellos en cualquier momento.
El sistema operativo garantiza que esta función sigue el modo de sincronización de nivel cero tal como se define en subprocesos y sincronización de nivel cero.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 8 |
| servidor mínimo admitido | Windows Server 2012 |
| de la plataforma de destino de | Escritorio |
| encabezado de | d3dkmddi.h |
| irQL | PASSIVE_LEVEL |
Consulte también
DXGKARGCB_NOTIFY_INTERRUPT_DATA