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 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 de D3DKMDT_VIDPN_TARGET_MODE . La estructura contiene una variedad de información sobre el modo de destino, incluidas sus características de identificación 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 ha realizado correctamente. |
| STATUS_GRAPHICS_INVALID_VIDPN_TARGETMODESET | El identificador proporcionado en hVidPnTargetModeSet no era válido. |
Comentarios
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 de conjunto de modo de destino VidPN llamando a pfnAcquireFirstModeInfo y, a continuación, realizando una secuencia de llamadas a pfnAcquireNextModeInfo.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Plataforma de destino | Escritorio |
| Encabezado | d3dkmddi.h (incluye D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |