Compartir a través de


DXGKDDI_VIDPN_RELEASETARGETMODESET función de devolución de llamada (d3dkmddi.h)

La función pfnReleaseTargetModeSet libera un identificador para 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 vidPN proporcionó anteriormente este identificador al controlador de miniport para mostrar 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 realizó 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 identificado por hVidPnTargetModeSet.

Observaciones

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 Valor
cliente mínimo admitido Windows Vista
de la plataforma de destino de Escritorio
encabezado de d3dkmddi.h (incluya D3dkmddi.h)
irQL PASSIVE_LEVEL

Consulte también

pfnAcquireTargetModeSet

pfnCreateNewTargetModeSet