Función D3DKMTPresent (d3dkmthk.h)

La función D3DKMTPresent envía un comando presente al subsistema del kernel de gráficos de Microsoft DirectX (Dxgkrnl.sys).

Sintaxis

NTSTATUS D3DKMTPresent(
  [in] D3DKMT_PRESENT *unnamedParam1
);

Parámetros

[in] unnamedParam1

pData: puntero a una estructura D3DKMT_PRESENT que describe los parámetros para presentar.

Valor devuelto

D3DKMTPresent devuelve un valor NTSTATUS, como uno de los siguientes valores:

Comentarios

La función D3DKMTPresent puede devolver STATUS_INVALID_PARAMETER, dependiendo de la combinación de valores de parámetro (es decir, los valores de los miembros de la estructura D3DKMT_PRESENT a la que apunta pData ). En la lista siguiente se describen las combinaciones más comunes de valores de parámetro que podrían provocar que D3DKMTPresent devuelva STATUS_INVALID PARAMETER:

• El miembro hDestination no es NULL y se cumple al menos una de las condiciones siguientes:

  • El miembro pSrcSubRects es NULL.
  • El miembro SubRectCnt es 0.
  • No se establece la marca de campo de bits Blt del miembro Flags .
  • No se ha establecido la marca de campo de bits SrcRectValid de Flags .
  • Se establece la marca de campo de bits ColorFill de Flags .
  • Se establece la marca de campo de bits FlipDoNotFlip, FlipDoNotWait o FlipRestart de Flags .
  • Se establece la marca de campo de bits SrcColorKey o DstColorKey de Flags .
  • El miembro hSource es igual a hDestination.
  • El origen y el destino no son una superficie principal.

• Se establece la marca de campo de bits Flip de Flags y se cumple al menos una de las condiciones siguientes:

  • Se establece la marca de campo de bits ColorFill de Flags .
  • Se establece la marca de campo de bits Blt de Flags .
  • Se establece la marca de campo de bits SrcColorKey o DstColorKey de Flags .
  • Se establece la marca de campo de bits SrcRectValid o DstRectValid de Flags .
  • Se establece la marca girar campo de bits de Flags .
  • Se establece la marca de campo de bits RestrictVidPnSource de Flags .
  • El origen no es una superficie principal.
  • El controlador de minipuerto de pantalla no admite el intervalo de volteo que especifica el miembro FlipInterval .
  • No se llamó previamente a la función D3DKMTSetDisplayMode .

• Se establece la marca de campo de bits ColorFill de Flags y se cumple una de las condiciones siguientes:

  • pSrcSubRects es NULL.
  • SubRectCnt es 0.
  • Se establece la marca de campo de bits Blt de Flags .
  • Se establece la marca de campo de bits FlipDoNotFlip, FlipDoNotWait o FlipRestart de Flags .
  • Se establece la marca de campo de bits SrcColorKey o DstColorKey de Flags .
  • Se establece la marca de campo de bits SrcRectValid de Flags .

• La marca de campo de bits Blt de Flags se establece y se cumple una de las condiciones siguientes:

  • pSrcSubRects es NULL.
  • SubRectCnt es 0.
  • Se establece la marca de campo de bits ColorFill de Flags .
  • Se establece la marca de campo de bits FlipDoNotFlip, FlipDoNotWait o FlipRestart de Flags .

Los controladores gráficos en modo de usuario que llaman a D3DKMTPresent para el estilo blit presentes, con la marca de campo de bits Blt de Flags establecida, deben tener especial cuidado para asegurarse de que todo el trabajo enviado previamente a los contextos que se presentan es totalmente purgable. Si no lo hace, se puede producir el interbloqueo de la aplicación o, en algunos casos, el interbloqueo del escritorio del usuario actual. Un contexto es totalmente purgable si solo contiene esperas en el objeto de sincronización de GPU donde la señal correspondiente ya se ha puesto en cola en la base de datos del programador de GPU y donde esa señal no está detrás de otra espera indestable. En otras palabras, si el espacio de usuario de todos los procesos del sistema se pausa inmediatamente después de la llamada a D3DKMTPresent, la espera se satisfacería una vez que la cadena de representación dependiente ya en cola al programador de GPU finalizaría la representación. Un controlador nunca debe llamar a blit presente en un contexto que dependa de una espera de GPU que no esté satisfecho actualmente y que se espera que alguna operación posterior se origine en este u otro proceso.

Ejemplos

En el ejemplo de código siguiente se muestra cómo un ICD de OpenGL puede usar D3DKMTPresent para presentar datos.

HRESULT Present(D3DKMT_HANDLE hDevice, 
                HWND hWnd, 
                RECT* pSrcRect,
                 RECT* pDstRect)
{
    D3DKMT_PRESENT PresentData = {0};

    PresentData.hDevice = hDevice;
    PresentData.Flags.Blt = 
    PresentData.Flags.DstRectValid = 
    PresentData.Flags.SrcRectValid = TRUE;
    PresentData.hWindow = hWnd;
    PresentData.DstRect = *pDstRect;
    PresentData.SrcRect = *pSrcRect;
    PresentData.SubRectCnt = 1;  
    PresentData.pSrcSubRects = pSrcRect; 

    if (NT_SUCCESS((*pfnKTPresent)(&PresentData))) {
        return S_OK;
    }
    return E_FAIL;
}

Requisitos

Consulte también

D3DKMTGetDeviceState

D3DKMTSetDisplayMode

D3DKMT_PRESENT