DXGKDDI_VIDPNTOPOLOGY_GETPATHSOURCEFROMTARGET função de retorno de chamada (d3dkmddi.h)
A função pfnGetPathSourceFromTarget retorna o identificador da origem presente do vídeo associada a um destino presente de vídeo especificado.
Sintaxe
DXGKDDI_VIDPNTOPOLOGY_GETPATHSOURCEFROMTARGET DxgkddiVidpntopologyGetpathsourcefromtarget;
NTSTATUS DxgkddiVidpntopologyGetpathsourcefromtarget(
[in] IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidTopology,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
[out] OUT_PD3DDDI_VIDEO_PRESENT_SOURCE_ID pVidPnSourceId
)
{...}
Parâmetros
[in] hVidTopology
Um identificador para um objeto de topologia VidPN. O driver de miniporto de exibição obteve esse identificador anteriormente chamando a função pfnGetTopology da interface DXGK_VIDPN_INTERFACE .
[in] VidPnTargetId
Um inteiro que identifica uma fonte de vídeo específica presente.
[out] pVidPnSourceId
Um ponteiro para uma variável que recebe o identificador da fonte presente do vídeo.
Retornar valor
A função pfnGetPathSourceFromTarget retorna um dos seguintes valores:
| Código de retorno | Descrição |
|---|---|
| STATUS_SUCCESS | A função foi bem-sucedida. |
| STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY | O identificador fornecido em hVidPnTopology era inválido. |
| STATUS_INVALID_PARAMETER | O ponteiro fornecido em pVidPnSourceId era válido. |
Comentários
Uma topologia é um caminho de coleção, cada um dos quais contém um par (origem, destino). Um destino específico pertence ao máximo um caminho, portanto, dada uma ID de destino, há no máximo uma fonte associada a esse destino.
Os identificadores de origem VidPN são atribuídos pelo sistema operacional. DxgkDdiStartDevice, implementado pelo driver de miniporto de exibição, retorna o número N de fontes presentes de vídeo compatíveis com o adaptador de exibição. Em seguida, o sistema operacional atribui identificadores 0, 1, 2, ... N - 1.
Os identificadores de destino VidPN são atribuídos pelo driver de miniporto de exibição. DxgkDdiQueryChildRelations, implementado pelo driver de miniporto de exibição, retorna uma matriz de estruturas DXGK_CHILD_DESCRIPTOR , cada uma contendo um identificador.
O tipo de dados D3DKMDT_HVIDPNTOPOLOGY é definido em D3dkmdt.h.
Os tipos de dados D3DDDI_VIDEO_PRESENT_SOURCE_ID D3DDDI_VIDEO_PRESENT_TARGET_ID são definidos em D3dukmdt.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 |