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

Consulte también

pfnAcquireTargetModeSet

pfnCreateNewTargetModeSet