DXGKDDI_VIDPN_ASSIGNSOURCEMODESET función de devolución de llamada (d3dkmddi.h)
La función pfnAssignSourceModeSet asigna un modo de origen establecido a un origen determinado en un VidPN especificado.
Sintaxis
DXGKDDI_VIDPN_ASSIGNSOURCEMODESET DxgkddiVidpnAssignsourcemodeset;
NTSTATUS DxgkddiVidpnAssignsourcemodeset(
[in] IN_D3DKMDT_HVIDPN hVidPn,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId,
[in] IN_CONST_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet
)
{...}
Parámetros
[in] hVidPn
Identificador de un objeto VidPN. El administrador vidPN proporcionó anteriormente este identificador al controlador de miniport para mostrar llamando a DxgkDdiEnumVidPnCofuncModality o DxgkDdiRecommendFunctionalVidPn.
[in] VidPnSourceId
Entero que identifica uno de los orígenes de vídeo asociados al objeto VidPN.
[in] hVidPnSourceModeSet
Identificador del objeto de conjunto del modo de origen que se va a asignar al origen identificado por VidPnSourceId. El controlador de minipuerto de pantalla obtuvo previamente este identificador llamando a pfnCreateNewSourceModeSet.
Valor devuelto
La función pfnAssignSourceModeSet devuelve uno de los siguientes valores:
| Código devuelto | Descripción |
|---|---|
| STATUS_SUCCESS | La función se realizó 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. |
| STATUS_GRAPHICS_INVALID_VIDPN_SOURCEMODESET | El identificador proporcionado en hVidPnSourceModeSet no era válido. |
| STATUS_GRAPHICS_PINNED_MODE_MUST_REMAIN_IN_SET | El modo de origen que está intentando asignar no contiene el modo que ya estaba anclado en el origen. |
Observaciones
El sistema operativo asigna los 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.
Si obtiene un identificador llamando a pfnCreateNewSourceModeSet y, a continuación, pasa ese identificador a pfnAssignSourceModeSet, no es necesario liberar el identificador llamando a pfnReleaseSourceModeSet.
Si obtiene un identificador llamando a pfnCreateNewSourceModeSet y decide no asignar el nuevo modo de origen establecido en un origen, debe liberar el identificador recién obtenido llamando a pfnReleaseSourceModeSet.
pfnAssignSourceModeSet no libera el objeto de conjunto del modo de origen si pfnAssignSourceModeSet produce un error con un parámetro de entrada no válido (es decir, se produce un error con el código de error STATUS_GRAPHICS_INVALID_VIDPN, STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_SOURCE o STATUS_GRAPHICS_INVALID_VIDPN_SOURCEMODESET) porque los parámetros especificados no eran suficientes para que el sistema operativo determine el modo establecido en liberar el objeto. Estas situaciones de parámetro no válidas indican un error de codificación grave en el controlador. Puede corregir este error especificando el identificador de vidPN correcto, el identificador de origen o el identificador de conjunto del modo de origen de VidPN.
pfnAssignSourceModeSet liberará el objeto set del modo de origen después de validar correctamente todos los parámetros de entrada si pfnAssignSourceModeSet produce un error debido a uno de los siguientes motivos:
- El conjunto de modo de origen está vacío.
- El conjunto de modo de origen no contiene un modo anclado en el conjunto de modo anterior, si existe.
- El conjunto de modo de origen no se creó para el origen identificado por VidPnSourceId.
Los tipos de datos D3DKMDT_HVIDPN y D3DKMDT_HVIDPNSOURCEMODESET se definen 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 |