Compartilhar via


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

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 miniporte 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.

Retornar valor

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.

Comentários

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 membro Id de uma estrutura D3DKMDT_VIDPN_TARGET_MODE e retorna a estrutura para o driver de miniporto de exibição.

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