DXGKDDI_VIDPN_ACQUIRESOURCEMODESET función de devolución de llamada (d3dkmddi.h)

Artículo
02/26/2024

La función pfnAcquireSourceModeSet devuelve un identificador a un objeto de conjunto de modo de origen determinado contenido por un objeto VidPN especificado.

Sintaxis

DXGKDDI_VIDPN_ACQUIRESOURCEMODESET DxgkddiVidpnAcquiresourcemodeset;

NTSTATUS DxgkddiVidpnAcquiresourcemodeset(
  [in]  IN_CONST_D3DKMDT_HVIDPN hVidPn,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId,
  [out] OUT_PD3DKMDT_HVIDPNSOURCEMODESET phVidPnSourceModeSet,
  [out] DEREF_OUT_CONST_PPDXGK_VIDPNSOURCEMODESET_INTERFACE ppVidPnSourceModeSetInterface
)
{...}

Parámetros

[in] hVidPn

Identificador de un objeto VidPN. El administrador vidPN proporcionó anteriormente este identificador al controlador de miniporte para mostrar llamando a DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn o DxgkDdiRecommendFunctionalVidPn.

[in] VidPnSourceId

Entero que identifica uno de los orígenes de vídeo asociados al objeto VidPN.

[out] phVidPnSourceModeSet

Puntero a una variable que recibe un identificador para el objeto de conjunto de modo de origen solicitado.

[out] ppVidPnSourceModeSetInterface

Puntero a una variable que recibe un puntero a una estructura de DXGK_VIDPNSOURCEMODESET_INTERFACE . La estructura contiene punteros a funciones a las que el controlador de miniporte de pantalla puede llamar para inspeccionar y modificar el objeto de conjunto del modo de origen.

Valor devuelto

La función pfnAcquireSourceModeSet devuelve uno de los siguientes valores:

Código devuelto	Descripción
STATUS_SUCCESS	La función se ha realizado correctamente.
STATUS_GRAPHICS_INVALID_VIDPN	El identificador proporcionado en hVidPn no era válido.
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_SOURCE	El identificador proporcionado en VidPnSourceId no era válido.

Comentarios

El sistema operativo asigna identificadores de origen vidPN. DxgkDdiStartDevice, implementado por el controlador de miniporte de pantalla, devuelve el número N de orígenes de vídeo presentes admitidos por el adaptador de pantalla. A continuación, el sistema operativo asigna identificadores 0, 1, 2, ... N - 1.

Cuando haya terminado de usar el identificador de objeto set del modo de origen, debe liberar el identificador llamando a pfnReleaseSourceModeSet. Los objetos del conjunto de modo de origen son referencias, por lo que si adquiere un identificador varias veces, debe liberarlo ese mismo número de veces.

La duración de la estructura DXGK_VIDPNSOURCEMODESET_INTERFACE devuelta en ppVidPnSourceModeSetInterface es propiedad del sistema operativo. Con este esquema de propiedad, el sistema operativo puede cambiar a implementaciones más recientes en tiempo de ejecución sin interrumpir a los clientes de la interfaz.

El tipo de datos D3DDDI_VIDEO_PRESENT_SOURCE_ID se define en D3dukmdt.h.

Los tipos de datos D3DKMDT_HVIDPN y D3DKMDT_HVIDPNSOURCEMODESET se definen en D3dkmdt.h.