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 establecido en modo de origen VidPN. El controlador de minipuerto de pantalla obtuvo previamente este identificador llamando a la función pfnAcquireSourceModeSet DXGK_VIDPN_INTERFACE 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 identificado 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 conjunto de modo de origen no tiene ningún modo anclado.
STATUS_GRAPHICS_INVALID_VIDPN_SOURCEMODESET	El identificador proporcionado en hVidPnSourceModeSet no era válido.

Observaciones

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

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

D3DKMDT_VIDPN_SOURCE_MODE

pfnPinMode

pfnReleaseModeInfo