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

La función pfnPinMode ancla un modo especificado en un conjunto de modo de destino VidPN.

Sintaxis

DXGKDDI_VIDPNTARGETMODESET_PINMODE DxgkddiVidpntargetmodesetPinmode;

NTSTATUS DxgkddiVidpntargetmodesetPinmode(
  [in] IN_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
  [in] IN_CONST_D3DKMDT_VIDEO_PRESENT_TARGET_MODE_ID VidPnTargetModeId
)
{...}

Parámetros

[in] hVidPnTargetModeSet

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

[in] VidPnTargetModeId

Entero que identifica el modo que se va a anclar.

Valor devuelto

La función pfnPinMode 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 modo identificado por VidPnTargetModeId no pertenece al conjunto de modo de origen representado por hVidPnTargetModeSet.

Comentarios

El sistema operativo asigna los identificadores del modo de destino vidPN. La función pfnCreateNewModeInfo genera un identificador de modo, asigna el identificador al miembro Id de una estructura de D3DKMDT_VIDPN_TARGET_MODE y devuelve la estructura al controlador de miniporte de pantalla.

El tipo de datos D3DKMDT_HVIDPNTARGETMODESET 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