DXGKDDI_VIDPNTARGETMODESET_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 destino VidPN especificado.
Sintaxis
DXGKDDI_VIDPNTARGETMODESET_ACQUIREFIRSTMODEINFO DxgkddiVidpntargetmodesetAcquirefirstmodeinfo;
NTSTATUS DxgkddiVidpntargetmodesetAcquirefirstmodeinfo(
[in] IN_CONST_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
[out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_TARGET_MODE ppFirstVidPnTargetModeInfo
)
{...}
Parámetros
[in] hVidPnTargetModeSet
Identificador de un objeto establecido en modo de destino VidPN. El controlador de miniporte de pantalla obtuvo previamente este identificador llamando a la función pfnAcquireTargetModeSet de la interfaz DXGK_VIDPN_INTERFACE.
[out] ppFirstVidPnTargetModeInfo
Puntero a una variable que recibe un puntero a una estructura D3DKMDT_VIDPN_TARGET_MODE. La estructura contiene una variedad de información sobre el modo de destino, incluidas sus características de identificador y señal de vídeo.
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_TARGETMODESET | El identificador proporcionado en hVidPnTargetModeSet no era válido. |
Observaciones
Cuando haya terminado de usar la estructura D3DKMDT_VIDPN_TARGET_MODE, debe liberar la estructura llamando a pfnReleaseModeInfo.
Puede enumerar todos los modos que pertenecen a un objeto establecido de modo de destino VidPN llamando a pfnAcquireFirstModeInfo y, a continuación, realizando una secuencia de llamadas a pfnAcquireNextModeInfo.
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 |