DXGKDDI_VIDPNSOURCEMODESET_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 origem VidPN especificado.
Sintaxe
DXGKDDI_VIDPNSOURCEMODESET_ACQUIREPINNEDMODEINFO DxgkddiVidpnsourcemodesetAcquirepinnedmodeinfo;
NTSTATUS DxgkddiVidpnsourcemodesetAcquirepinnedmodeinfo(
[in] IN_CONST_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
[out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_SOURCE_MODE ppPinnedVidPnSourceModeInfo
)
{...}
Parâmetros
[in] hVidPnSourceModeSet
Um identificador para um objeto de conjunto de modo de origem VidPN. O driver de miniporto de exibição obteve esse identificador anteriormente chamando a função pfnAcquireSourceModeSet da interface DXGK_VIDPN_INTERFACE.
[out] ppPinnedVidPnSourceModeInfo
Um ponteiro para uma variável que recebe um ponteiro para uma estrutura D3DKMDT_VIDPN_SOURCE_MODE. A estrutura contém uma variedade de informações sobre o modo fixado, incluindo sua ID, tipo e formato de renderização. Se o conjunto de modo de origem identificado por hVidPnSourceModeSet não tiver modo fixado, essa variável receberá um ponteiro NULL.
Valor de retorno
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 ppPinnedVidPnSourceModeInfo como o endereço de D3DKMDT_VIDPN_SOURCE_MODE estrutura que descreve o modo fixado. 2. Definindo ppPinnedVidPnSourceModeInfo como NULL para indicar que o conjunto de modo de origem não tem modo fixado. |
| STATUS_GRAPHICS_INVALID_VIDPN_SOURCEMODESET | O identificador fornecido em hVidPnSourceModeSet era inválido. |
Observações
Quando terminar de usar a estrutura D3DKMDT_VIDPN_SOURCE_MODE, você deverá liberar a estrutura chamando pfnReleaseModeInfo.
O tipo de dados D3DKMDT_HVIDPNSOURCEMODESET é 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 |