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

Artigo
02/06/2025

A função pfnPinMode fixa um modo especificado em um conjunto de modo de destino VidPN.

Sintaxe

DXGKDDI_VIDPNTARGETMODESET_PINMODE DxgkddiVidpntargetmodesetPinmode;

NTSTATUS DxgkddiVidpntargetmodesetPinmode(
  [in] IN_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
  [in] IN_CONST_D3DKMDT_VIDEO_PRESENT_TARGET_MODE_ID VidPnTargetModeId
)
{...}

Parâmetros

[in] hVidPnTargetModeSet

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

[in] VidPnTargetModeId

Um inteiro que identifica o modo a ser fixado.

Valor de retorno

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

Código de retorno	Descrição
STATUS_SUCCESS	A função foi bem-sucedida.
STATUS_GRAPHICS_INVALID_VIDPN_TARGETMODESET	O identificador fornecido em hVidPnTargetModeSet era inválido.
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET_MODE	O modo identificado por VidPnTargetModeId não pertence ao conjunto de modo de origem representado por hVidPnTargetModeSet.

Observações

Os identificadores do modo de destino VidPN são atribuídos pelo sistema operacional. A função pfnCreateNewModeInfo gera um identificador de modo, atribui o identificador ao ID membro de uma estrutura D3DKMDT_VIDPN_TARGET_MODE e retorna a estrutura ao driver de miniporto de exibição.

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

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista
da Plataforma de Destino	Área de trabalho
cabeçalho	d3dkmddi.h (inclua D3dkmddi.h)
IRQL	PASSIVE_LEVEL

Partilhar via