DXGKDDI_RECOMMENDVIDPNTOPOLOGY função de retorno de chamada (d3dkmddi.h)
A função DxgkDdiRecommendVidPnTopology cria a topologia de um VidPN especificado ou aumenta a topologia com um novo caminho para destinos presentes em vídeo.
Sintaxe
DXGKDDI_RECOMMENDVIDPNTOPOLOGY DxgkddiRecommendvidpntopology;
NTSTATUS DxgkddiRecommendvidpntopology(
IN_CONST_HANDLE hAdapter,
[in] IN_CONST_PDXGKARG_RECOMMENDVIDPNTOPOLOGY_CONST pRecommendVidPnTopology
)
{...}
Parâmetros
hAdapter
Um identificador para um bloco de contexto associado a um adaptador de exibição. O driver de miniporto de exibição forneceu anteriormente esse identificador para o subsistema de kernel de elementos gráficos do Microsoft DirectX na função MiniportDeviceContext da função DxgkDdiAddDevice.
[in] pRecommendVidPnTopology
Um ponteiro para uma estrutura DXGKARG_RECOMMENDVIDPNTOPOLOGY que contém argumentos de função.
Valor de retorno
DxgkDdiRecommendVidPnTopology retorna um dos seguintes valores:
| Código de retorno | Descrição |
|---|---|
| STATUS_SUCCESS | A função criou ou aumentou com êxito a topologia. |
| STATUS_GRAPHICS_NO_RECOMMENDED_VIDPN_TOPOLOGY | A função não tem nenhuma recomendação para o aumento da topologia VidPN especificada. |
| STATUS_GRAPHICS_CANCEL_VIDPN_TOPOLOGY_AUGMENTATION | A função recomenda cancelar o aumento da topologia do VidPN especificada na origem especificada. Esse código de retorno é permitido somente no caso de aumento da topologia VidPN. |
| STATUS_NO_MEMORY | A função falhou porque não foi possível alocar memória suficiente. |
O driver de miniporto deve passar por qualquer código de erro que ele obtém do sistema operacional para o qual ele não tem um caminho de código de fallback.
Observações
DxgkDdiRecommendVidPnTopology deve ficar paginável.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows Vista |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |