DXGKDDI_VIDPNTARGETMODESET_ACQUIREFIRSTMODEINFO função de retorno de chamada (d3dkmddi.h)
A função pfnAcquireFirstModeInfo retorna um descritor do primeiro modo em um conjunto de modo de destino VidPN especificado.
Sintaxe
DXGKDDI_VIDPNTARGETMODESET_ACQUIREFIRSTMODEINFO DxgkddiVidpntargetmodesetAcquirefirstmodeinfo;
NTSTATUS DxgkddiVidpntargetmodesetAcquirefirstmodeinfo(
[in] IN_CONST_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
[out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_TARGET_MODE ppFirstVidPnTargetModeInfo
)
{...}
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] ppFirstVidPnTargetModeInfo
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 de destino, incluindo suas características de ID e sinal de vídeo.
Retornar valor
A função pfnAcquireFirstModeInfo 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. |
Comentários
Quando terminar de usar a estrutura D3DKMDT_VIDPN_TARGET_MODE, você deverá liberar a estrutura chamando pfnReleaseModeInfo.
Você pode enumerar todos os modos que pertencem a um objeto de conjunto de modo de destino VidPN chamando pfnAcquireFirstModeInfo e, em seguida, fazendo uma sequência de chamadas para pfnAcquireNextModeInfo.
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 |