Compartilhar via


DXGKDDI_VIDPNTARGETMODESET_ACQUIREPINNEDMODEINFO função de retorno de chamada (d3dkmddi.h)

A função pfnAcquirePinnedModeInfo retorna um descritor do modo fixado em um conjunto de modo de destino VidPN especificado.

Sintaxe

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

Um identificador para um objeto de conjunto de modo de destino VidPN. O driver de miniporta de exibição obteve esse identificador anteriormente chamando a função pfnAcquireTargetModeSet da interface DXGK_VIDPN_INTERFACE .

[out] ppPinnedVidPnTargetModeInfo

Um ponteiro para uma variável que recebe um ponteiro para uma estrutura D3DKMDT_VIDPN_TARGET_MODE . A estrutura contém uma variedade de informações sobre o modo fixado, incluindo suas características de ID e sinal de vídeo. Se o conjunto de modo de destino identificado por hVidPnTargetModeSet não tiver nenhum modo fixado, essa variável receberá um ponteiro NULL .

Retornar valor

A função pfnAcquirePinnedModeInfo retorna um dos seguintes valores:

Código de retorno Descrição
STATUS_SUCCESS A função foi bem-sucedida fazendo um dos seguintes procedimentos:
1. Definindo ppPinnedVidPnTargetModeInfo como o endereço de D3DKMDT_VIDPN_TARGET_MODE estrutura que descreve o modo fixado.
2. Definindo ppPinnedVidPnTargetModeInfo como NULL para indicar que o modo de destino definido não tem modo fixado.
STATUS_GRAPHICS_INVALID_VIDPN_TARGETMODESET O identificador fornecido em hVidPnTargetModeSet era inválido.

Comentários

Quando terminar de usar a estrutura D3DKMDT_VIDPN_TARGET_MODE , você deverá liberar a estrutura chamando pfnReleaseModeInfo.

O tipo de dados D3DKMDT_HVIDPNTARGETMODESET é definido em D3dkmdt.h.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista
Plataforma de Destino Área de Trabalho
Cabeçalho d3dkmddi.h (inclua D3dkmddi.h)
IRQL PASSIVE_LEVEL

Confira também

D3DKMDT_VIDPN_TARGET_MODE

pfnPinMode

pfnReleaseModeInfo