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 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 de D3DKMDT_VIDPN_TARGET_MODE . La estructura contiene una variedad de información sobre el modo anclado, incluidas sus características de identificador y señal de vídeo. Si el modo de destino establecido identificado 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 mediante 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. |
Comentarios
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 | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Plataforma de destino | Escritorio |
| Encabezado | d3dkmddi.h (incluye D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |