DXGKDDI_VIDPNTARGETMODESET_ACQUIREPINNEDMODEINFO función de devolución de llamada (d3dkmddi.h)
La función pfnAcquirePinnedModeInfo devuelve un descriptor del modo anclado en un conjunto de modo de destino VidPN especificado.
Sintaxis
DXGKDDI_VIDPNTARGETMODESET_ACQUIREPINNEDMODEINFO DxgkddiVidpntargetmodesetAcquirepinnedmodeinfo;
NTSTATUS DxgkddiVidpntargetmodesetAcquirepinnedmodeinfo(
[in] IN_CONST_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
[out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_TARGET_MODE ppPinnedVidPnTargetModeInfo
)
{...}
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] ppPinnedVidPnTargetModeInfo
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 anclado, incluidas sus características de identificación y señal de vídeo. Si el modo de destino definido por hVidPnTargetModeSet no tiene ningún modo anclado, esta variable recibe un puntero NULL.
Valor devuelto
La función pfnAcquirePinnedModeInfo devuelve uno de los siguientes valores:
| Código devuelto | Descripción |
|---|---|
| STATUS_SUCCESS | La función se realizó correctamente realizando una de las siguientes acciones: 1. Establecer ppPinnedVidPnTargetModeInfo en la dirección de D3DKMDT_VIDPN_TARGET_MODE estructura que describe el modo anclado. 2. Establecer ppPinnedVidPnTargetModeInfo en NULL para indicar que el conjunto de modo de destino no tiene ningún modo anclado. |
| 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.
El tipo de datos D3DKMDT_HVIDPNTARGETMODESET 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 |