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 miniporte de pantalla obtuvo anteriormente este identificador llamando a la función pfnAcquireSourceModeSet de la interfaz DXGK_VIDPN_INTERFACE .
[out] ppFirstVidPnSourceModeInfo
Puntero a una variable que recibe un puntero a una estructura de 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 ha realizado correctamente. |
| 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.
Puede enumerar todos los modos que pertenecen a un objeto de conjunto 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 | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Plataforma de destino | Escritorio |
| Encabezado | d3dkmddi.h (incluye D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |