DXGKDDI_VIDPN_RELEASETARGETMODESET función de devolución de llamada (d3dkmddi.h)
La función pfnReleaseTargetModeSet libera un identificador en un objeto de conjunto de modo de destino.
Sintaxis
DXGKDDI_VIDPN_RELEASETARGETMODESET DxgkddiVidpnReleasetargetmodeset;
NTSTATUS DxgkddiVidpnReleasetargetmodeset(
[in] IN_CONST_D3DKMDT_HVIDPN hVidPn,
[in] IN_CONST_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet
)
{...}
Parámetros
[in] hVidPn
Identificador de un objeto VidPN que contiene el objeto de conjunto de modo de destino. El administrador de VidPN previamente proporcionó este identificador al controlador de minipuerto de pantalla llamando a DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn o DxgkDdiRecommendFunctionalVidPn.
[in] hVidPnTargetModeSet
Identificador que se va a liberar.
Valor devuelto
La función pfnReleaseTargetModeSet 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_VIDPN_TARGETMODESET | El identificador proporcionado en hVidPnTargetModeSet no era válido. |
| STATUS_GRAPHICS_RESOURCES_NOT_RELATED | El VidPN identificado por hVidPn no contiene el modo de destino establecido por hVidPnTargetModeSet. |
Comentarios
Cuando haya terminado de usar un identificador que obtuvo llamando a pfnAcquireTargetModeSet, debe liberar el identificador llamando a pfnReleaseTargetModeSet.
Si obtiene un identificador llamando a pfnCreateNewTargetModeSet y, a continuación, pasa ese identificador a pfnAssignTargetModeSet, no es necesario liberar el identificador.
Si obtiene un identificador llamando a pfnCreateNewTargetModeSet y decide no asignar el nuevo modo de origen establecido en un origen, debe liberar el identificador recién obtenido llamando a pfnReleaseTargetModeSet.
Los tipos de datos D3DKMDT_HVIDPN y D3DKMDT_HVIDPNTARGETMODESET se definen 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 |