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

La función pfnAcquirePinnedModeInfo devuelve un descriptor del modo anclado en un conjunto de modo de origen VidPN especificado.

Sintaxis

DXGKDDI_VIDPNSOURCEMODESET_ACQUIREPINNEDMODEINFO DxgkddiVidpnsourcemodesetAcquirepinnedmodeinfo;

NTSTATUS DxgkddiVidpnsourcemodesetAcquirepinnedmodeinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
  [out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_SOURCE_MODE ppPinnedVidPnSourceModeInfo
)
{...}

Parámetros

[in] hVidPnSourceModeSet

Identificador de un objeto de conjunto de modo de origen VidPN. El controlador de minipuerto de pantalla obtuvo previamente este identificador llamando a la función pfnAcquireSourceModeSet de la interfaz DXGK_VIDPN_INTERFACE .

[out] ppPinnedVidPnSourceModeInfo

Puntero a una variable que recibe un puntero a una estructura D3DKMDT_VIDPN_SOURCE_MODE . La estructura contiene una variedad de información sobre el modo anclado, incluido su identificador, tipo y formato de representación. Si el modo de origen establecido por hVidPnSourceModeSet no tiene ningún modo anclado, esta variable recibe un puntero NULL .

Valor devuelto

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

Código devuelto Descripción
STATUS_SUCCESS La función se realizó correctamente realizando una de las siguientes acciones:
1. Establecer ppPinnedVidPnSourceModeInfo en la dirección de D3DKMDT_VIDPN_SOURCE_MODE estructura que describe el modo anclado.
2. Establecer ppPinnedVidPnSourceModeInfo en NULL para indicar que el modo de origen establecido no tiene modo anclado.
STATUS_GRAPHICS_INVALID_VIDPN_SOURCEMODESET El identificador proporcionado en hVidPnSourceModeSet no era válido.

Comentarios

Cuando haya terminado de usar la estructura D3DKMDT_VIDPN_SOURCE_MODE, debe liberar la estructura llamando a pfnReleaseModeInfo.

El tipo de datos D3DKMDT_HVIDPNSOURCEMODESET se define 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

D3DKMDT_VIDPN_SOURCE_MODE

pfnPinMode

pfnReleaseModeInfo