DXGKDDI_VIDPNSOURCEMODESET_ADDMODE função de retorno de chamada (d3dkmddi.h)
A função pfnAddMode adiciona um modo de origem VidPN a um objeto de conjunto de modo de origem VidPN especificado.
Sintaxe
DXGKDDI_VIDPNSOURCEMODESET_ADDMODE DxgkddiVidpnsourcemodesetAddmode;
NTSTATUS DxgkddiVidpnsourcemodesetAddmode(
[in] IN_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
[in] IN_PD3DKMDT_VIDPN_SOURCE_MODE_CONST pVidPnSourceModeInfo
)
{...}
Parâmetros
[in] hVidPnSourceModeSet
Um identificador para um objeto de conjunto de modo de origem VidPN. O driver de miniporta de exibição obteve esse identificador anteriormente chamando a função pfnAcquireSourceModeSet da interface DXGK_VIDPN_INTERFACE .
[in] pVidPnSourceModeInfo
Um ponteiro para uma estrutura D3DKMDT_VIDPN_SOURCE_MODE que descreve o modo de origem. O driver de miniporto de exibição obteve essa estrutura anteriormente chamando pfnCreateNewModeInfo.
Retornar valor
A função pfnAddMode retorna um dos seguintes valores:
| Código de retorno | Descrição |
|---|---|
| STATUS_SUCCESS | A função foi bem-sucedida. |
| STATUS_GRAPHICS_INVALID_VIDPN_SOURCEMODESET | O identificador fornecido em hVidPnSourceModeSet era inválido. |
Comentários
Para adicionar um modo a um conjunto de modo de origem, o driver de miniporta de exibição executa as etapas a seguir.
Chame pfnCreateNewModeInfo para obter um ponteiro para uma estrutura D3DKMDT_VIDPN_SOURCE_MODE . A função pnfCreateNewModeInfo aloca a estrutura, preenche o membro Id com um identificador de modo de origem recém-gerado e define o membro Type como D3DKMDT_RMT_UNINITIALIZED.
Preencha a estrutura de D3DKMDT_VIDPN_SOURCE_MODE (exceto o membro ID ) com informações sobre o modo, incluindo o tipo e o formato do modo.
Chame pfnAddMode para adicionar o modo a um conjunto de modo de origem.
O gerenciador VidPN aloca uma estrutura D3DKMDT_VIDPN_SOURCE_MODE quando você chama pfnCreateNewModeInfo. Se você adicionar o modo descrito por essa estrutura a um conjunto de modo de origem, não precisará liberar explicitamente a estrutura; pfnAddMode o libera.
Se você obtiver uma estrutura D3DKMDT_VIDPN_SOURCE_MODE chamando pfnCreateNewModeInfo e decidir não adicionar esse modo a um conjunto de modo de origem, deverá liberar explicitamente a estrutura chamando pfnReleaseModeInfo.
O tipo de dados D3DKMDT_HVIDPNSOURCEMODESET é 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 |