DXGKDDI_VIDPNSOURCEMODESET_ADDMODE función de devolución de llamada (d3dkmddi.h)
La función pfnAddMode agrega un modo de origen VidPN a un objeto de conjunto de modo de origen VidPN especificado.
Sintaxis
DXGKDDI_VIDPNSOURCEMODESET_ADDMODE DxgkddiVidpnsourcemodesetAddmode;
NTSTATUS DxgkddiVidpnsourcemodesetAddmode(
[in] IN_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
[in] IN_PD3DKMDT_VIDPN_SOURCE_MODE_CONST pVidPnSourceModeInfo
)
{...}
Parámetros
[in] hVidPnSourceModeSet
Identificador de un objeto de conjunto de modo de origen VidPN. El controlador de minipuerto de pantalla obtuvo previamente este identificador llamando a la función pfnAcquireSourceModeSet de la interfaz DXGK_VIDPN_INTERFACE .
[in] pVidPnSourceModeInfo
Puntero a una estructura de D3DKMDT_VIDPN_SOURCE_MODE que describe el modo de origen. El controlador de minipuerto de pantalla obtuvo previamente esta estructura mediante una llamada a pfnCreateNewModeInfo.
Valor devuelto
La función pfnAddMode devuelve uno de los siguientes valores:
| Código devuelto | Descripción |
|---|---|
| STATUS_SUCCESS | La función se ha realizado correctamente. |
| STATUS_GRAPHICS_INVALID_VIDPN_SOURCEMODESET | El identificador proporcionado en hVidPnSourceModeSet no era válido. |
Comentarios
Para agregar un modo a un conjunto de modo de origen, el controlador de minipuerto de pantalla realiza los pasos siguientes.
Llame a pfnCreateNewModeInfo para obtener un puntero a una estructura de D3DKMDT_VIDPN_SOURCE_MODE . La función pnfCreateNewModeInfo asigna la estructura, rellena el miembro Id con un identificador de modo de origen recién generado y establece el miembro Type en D3DKMDT_RMT_UNINITIALIZED.
Rellene la estructura de D3DKMDT_VIDPN_SOURCE_MODE (excepto el miembro Id ) con información sobre el modo, incluido el tipo y el formato del modo.
Llame a pfnAddMode para agregar el modo a un conjunto de modo de origen.
El administrador vidPN asigna una estructura de D3DKMDT_VIDPN_SOURCE_MODE cuando se llama a pfnCreateNewModeInfo. Si agrega el modo descrito por esa estructura a un conjunto de modo de origen, no es necesario liberar explícitamente la estructura; pfnAddMode lo libera.
Si obtiene una estructura de D3DKMDT_VIDPN_SOURCE_MODE llamando a pfnCreateNewModeInfo y decide no agregar ese modo a un conjunto de modo de origen, debe liberar explícitamente la estructura llamando a pfnReleaseModeInfo.
El tipo de datos D3DKMDT_HVIDPNSOURCEMODESET se define en D3dkmdt.h.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Plataforma de destino | Escritorio |
| Encabezado | d3dkmddi.h (incluya D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |