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

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

Sintaxis

DXGKDDI_VIDPNSOURCEMODESET_ACQUIREFIRSTMODEINFO DxgkddiVidpnsourcemodesetAcquirefirstmodeinfo;

NTSTATUS DxgkddiVidpnsourcemodesetAcquirefirstmodeinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
  [out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_SOURCE_MODE ppFirstVidPnSourceModeInfo
)
{...}

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] ppFirstVidPnSourceModeInfo

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, incluido su identificador, tipo y formato de representación.

Valor devuelto

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

Código devuelto	Descripción
STATUS_SUCCESS	La función se realizó correctamente.
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.

Puede enumerar todos los modos que pertenecen a un objeto establecido de modo de origen VidPN llamando a pfnAcquireFirstModeInfo y, a continuación, realizando una secuencia de llamadas a pfnAcquireNextModeInfo.

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

pfnAcquireNextModeInfo

pfnReleaseModeInfo