DXGKDDI_VIDPN_ACQUIRESOURCEMODESET función de devolución de llamada (d3dkmddi.h)
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.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Plataforma de destino | Escritorio |
| Encabezado | d3dkmddi.h (incluye D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |