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

Artículo
05/26/2023

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

Sintaxis

DXGKDDI_VIDPNSOURCEMODESET_RELEASEMODEINFO DxgkddiVidpnsourcemodesetReleasemodeinfo;

NTSTATUS DxgkddiVidpnsourcemodesetReleasemodeinfo(
  [in] IN_CONST_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
  [in] IN_CONST_PD3DKMDT_VIDPN_SOURCE_MODE_CONST pVidPnSourceModeInfo
)
{...}

Parámetros

[in] hVidPnSourceModeSet

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

[in] pVidPnSourceModeInfo

Puntero a la estructura D3DKMDT_VIDPN_SOURCE_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_SOURCEMODESET	El identificador proporcionado en hVidPnSourceModeSet no era válido.
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_SOURCE_MODE	El puntero proporcionado en pVidPnSourceModeInfo no era válido.

Comentarios

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

Si obtiene una estructura de D3DKMDT_VIDPN_SOURCE_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 modo de origen, debe liberar la estructura recién creada llamando a pfnReleaseModeInfo.

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