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

  • Artigo

A função pfnAcquireTargetModeSet retorna um identificador para um determinado objeto de conjunto de modo de destino contido por um objeto VidPN especificado.

Sintaxe

DXGKDDI_VIDPN_ACQUIRETARGETMODESET DxgkddiVidpnAcquiretargetmodeset;

NTSTATUS DxgkddiVidpnAcquiretargetmodeset(
  [in]  IN_CONST_D3DKMDT_HVIDPN hVidPn,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
  [out] OUT_PD3DKMDT_HVIDPNTARGETMODESET phVidPnTargetModeSet,
  [out] DEREF_OUT_CONST_PPDXGK_VIDPNTARGETMODESET_INTERFACE ppVidPnTargetModeSetInterface
)
{...}

Parâmetros

[in] hVidPn

Um identificador para um objeto VidPN. O gerenciador VidPN forneceu anteriormente esse identificador para o driver de miniporta de exibição chamando DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn ou DxgkDdiRecommendFunctionalVidPn.

[in] VidPnTargetId

Um inteiro que identifica um dos destinos de vídeo presentes associados ao objeto VidPN.

[out] phVidPnTargetModeSet

Um ponteiro para uma variável que recebe um identificador para o objeto de conjunto de modo de destino solicitado.

[out] ppVidPnTargetModeSetInterface

Um ponteiro para uma variável que recebe um ponteiro para uma estrutura DXGK_VIDPNTARGETMODESET_INTERFACE . A estrutura contém ponteiros para funções que o driver de miniporto de exibição pode chamar para inspecionar e alterar o objeto de conjunto de modo de destino.

Retornar valor

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

Código de retorno Descrição
STATUS_SUCCESS A função foi bem-sucedida.
STATUS_GRAPHICS_INVALID_VIDPN O identificador fornecido no hVidPn era inválido.
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET O identificador fornecido em VidPnTargetId era inválido.

Comentários

Os identificadores de destino VidPN são atribuídos pelo driver de miniporta de exibição. DxgkDdiQueryChildRelations, implementado pelo driver de miniporto de exibição, retorna uma matriz de estruturas DXGK_CHILD_DESCRIPTOR , cada uma contendo um identificador.

Quando terminar de usar o identificador de objeto do conjunto de modo de destino, você deverá liberar o identificador chamando pfnReleaseTargetModeSet. Os objetos de conjunto de modo de destino são contados por referência, portanto, se você adquirir um identificador várias vezes, deverá liberá-lo no mesmo número de vezes.

O tempo de vida da estrutura de DXGK_VIDPNTARGETMODESET_INTERFACE retornado em ppVidPnTargetModeSetInterface pertence ao sistema operacional. Usando esse esquema de propriedade, o sistema operacional pode alternar para implementações mais recentes em tempo de execução sem interromper os clientes da interface.

O tipo de dados D3DDDI_VIDEO_PRESENT_TARGET_ID é definido em D3dukmdt.h.

Os tipos de dados D3DKMDT_HVIDPN e D3DKMDT_HVIDPNTARGETMODESET são definidos 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

Interface de definição do modo de destino VidPN

pfnAssignTargetModeSet

pfnCreateNewTargetModeSet

pfnReleaseTargetModeSet