DXGKCB_ACQUIRE_POST_DISPLAY_OWNERSHIP función de devolución de llamada (dispmprt.h)

Artículo
08/07/2023

Llamado por un controlador de miniporte de pantalla de Windows Display Driver (WDDM) 1.2 o posterior para obtener la información de visualización del dispositivo de visualización de prueba automática (POST) actual o del controlador WDDM que se estaba ejecutando anteriormente.

El controlador debe usar esta información para mostrar para optimizar la solicitud de cambio de modo inicial una vez iniciado el dispositivo de visualización.

Sintaxis

DXGKCB_ACQUIRE_POST_DISPLAY_OWNERSHIP DxgkcbAcquirePostDisplayOwnership;

NTSTATUS DxgkcbAcquirePostDisplayOwnership(
  [in]  HANDLE DeviceHandle,
  [out] PDXGK_DISPLAY_INFORMATION DisplayInfo
)
{...}

Parámetros

[in] DeviceHandle

Identificador que representa un adaptador de pantalla. El controlador de minipuerto de pantalla obtuvo previamente este identificador en el miembro DeviceHandle de la estructura DXGKRNL_INTERFACE que se pasó a DxgkDdiStartDevice.

[out] DisplayInfo

Puntero a una estructura de DXGK_DISPLAY_INFORMATION asignada por el controlador de minipuerto de pantalla. Si DxgkCbAcquirePostDisplayOwnership devuelve STATUS_SUCCESS, esta estructura contiene información para mostrar del dispositivo de visualización actual que se usa para las operaciones POST.

Valor devuelto

DxgkCbAcquirePostDisplayOwnership devuelve STATUS_SUCCESS si se realiza correctamente. De lo contrario, devuelve uno de los códigos de error definidos en Ntstatus.h.

Comentarios

Formatos de color permitidos

El miembro DisplayInfo->ColorFormat debe incluir una combinación or bit a bit de los dos formatos siguientes:

D3DDDIFMT_X8R8G8B8
D3DDDIFMT_A8R8G8B8

Si el sistema operativo informa del formato D3DDDIFMT_R8G8B8 , el controlador de minipuerto de pantalla debe ignorarlo.

Inicialización de destino de presentación de vídeo

Es posible que el miembro DisplayInfo->TargetId no se inicialice. En este caso, el identificador del destino del vídeo presente es D3DDDI_ID_UNINITIALIZED. Normalmente, esto ocurre después de un arranque del sistema.

Del mismo modo, es posible que el miembro DisplayInfo-AcpiId> no se inicialice. En este caso, el identificador ACPI AcpiId tiene un valor de cero.

En el caso de una actualización del controlador a controlador, el controlador anterior habrá proporcionado el identificador de destino y el identificador ACPI.

Directrices de implementación

A partir de WDDM 1.2, el controlador de minipuerto de pantalla debe seguir estas directrices cuando llama a DxgkCbAcquirePostDisplayOwnership:

El punto de entrada de la función DxgkCbAcquirePostDisplayOwnership forma parte de la estructura DXGKRNL_INTERFACE . Esta estructura se devuelve al controlador a través del parámetro DxgkInterface cuando se llama a la función DxgkDdiStartDevice del controlador.
Es opcional que el controlador de miniporte de pantalla llame a DxgkCbAcquirePostDisplayOwnership. Sin embargo, el sistema operativo podría seguir llamando a la función DxgkDdiStopDeviceAndReleasePostDisplayOwnership del controlador del dispositivo si el controlador no llamó previamente a DxgkCbAcquirePostDisplayOwnership.
El controlador de minipuerto de pantalla puede llamar a DxgkCbAcquirePostDisplayOwnership si el dispositivo se inicia en respuesta a un evento Plug and Play (PnP). En este caso, el controlador debe llamar a DxgkCbAcquirePostDisplayOwnership desde el contexto de la llamada a la función DxgkDdiStartDevice .
El controlador de minipuerto de pantalla puede llamar a DxgkCbAcquirePostDisplayOwnership si el dispositivo reanuda un estado de alimentación PowerDeviceD0 después de un estado de hibernación. En este caso, el controlador debe llamar a DxgkCbAcquirePostDisplayOwnership desde el contexto de la llamada a la función DxgkDdiSetPowerState .
El controlador de minipuerto de pantalla solo debe llamar a la función DxgkCbAcquirePostDisplayOwnership si el controlador se ejecuta en Windows 8 o una versión posterior del sistema operativo Windows.
Nota El controlador de miniporte de pantalla puede llamar a RtlGetVersion para determinar la versión del sistema operativo.
DxgkCbAcquirePostDisplayOwnership puede devolver una estructura de DXGK_DISPLAY_INFORMATION con el miembro Width establecido en cero. Esto indica que el dispositivo de pantalla actual no es capaz de operaciones POST o que el sistema operativo no tiene la información de visualización actual para el dispositivo POST actual.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8
Servidor mínimo compatible	Windows Server 2012
Plataforma de destino	Escritorio
Encabezado	dispmprt.h (include Dispmprt.h)
IRQL	<= APC_LEVEL