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 establecido 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 establecido en modo de origen VidPN. El controlador de minipuerto de pantalla obtuvo previamente este identificador llamando a la función pfnAcquireSourceModeSet DXGK_VIDPN_INTERFACE de la interfaz DXGK_VIDPN_INTERFACE.
[in] pVidPnSourceModeInfo
Puntero a una estructura D3DKMDT_VIDPN_SOURCE_MODE que describe el modo de origen. El controlador de miniporte de pantalla obtuvo previamente esta estructura llamando 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 realizó correctamente. |
| STATUS_GRAPHICS_INVALID_VIDPN_SOURCEMODESET | El identificador proporcionado en hVidPnSourceModeSet no era válido. |
Observaciones
Para agregar un modo a un conjunto de modos 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. de con un identificador de modo de origen recién generado y establece el miembro Type en D3DKMDT_RMT_UNINITIALIZED.
Rellene la estructura D3DKMDT_VIDPN_SOURCE_MODE (excepto el id. miembro) 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 | Valor |
|---|---|
| cliente mínimo admitido | Windows Vista |
| de la plataforma de destino de | Escritorio |
| encabezado de | d3dkmddi.h (incluya D3dkmddi.h) |
| irQL | PASSIVE_LEVEL |