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

Artículo
02/26/2024

La función pfnReleaseModeInfo libera una estructura de D3DKMDT_VIDPN_TARGET_MODE que el administrador vidPN proporcionó anteriormente al controlador de minipuerto de pantalla.

Sintaxis

DXGKDDI_VIDPNTARGETMODESET_RELEASEMODEINFO DxgkddiVidpntargetmodesetReleasemodeinfo;

NTSTATUS DxgkddiVidpntargetmodesetReleasemodeinfo(
  [in] IN_CONST_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
  [in] IN_CONST_PD3DKMDT_VIDPN_TARGET_MODE_CONST pVidPnTargetModeInfo
)
{...}

Parámetros

[in] hVidPnTargetModeSet

Identificador de un objeto establecido en modo de destino VidPN. El controlador de miniporte de pantalla obtuvo este identificador llamando a la función pfnAcquireTargetModeSet de la interfaz DXGK_VIDPN_INTERFACE .

[in] pVidPnTargetModeInfo

Puntero a la estructura D3DKMDT_VIDPN_TARGET_MODE que se va a liberar.

Valor devuelto

La función pfnReleaseModeInfo devuelve uno de los siguientes valores:

Código devuelto	Descripción
STATUS_SUCCESS	La función se ha realizado correctamente.
STATUS_GRAPHICS_INVALID_VIDPN_TARGETMODESET	El identificador proporcionado en hVidPnTargetModeSet no era válido.
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET_MODE	El puntero proporcionado en pVidPnTargetModeInfo no era válido.

Comentarios

Cuando haya terminado de usar una estructura de D3DKMDT_VIDPN_TARGET_MODE que obtuvo llamando a cualquiera de las funciones siguientes, debe liberar la estructura llamando a pfnReleaseModeInfo.

Si obtiene una estructura de D3DKMDT_VIDPN_TARGET_MODE llamando a pfnCreateNewModeInfo y, a continuación, pasa esa estructura a pfnAddMode, no es necesario liberar la estructura.

Si obtiene un identificador llamando a pfnCreateNewModeInfo y decide no agregar el nuevo modo a un conjunto de modos de destino, debe liberar la estructura recién creada llamando a pfnReleaseModeInfo.

El tipo de datos D3DKMDT_HVIDPNSOURCEMODESET se define en D3dkmdt.h.