DXGKDDI_GETNODEMETADATA função de retorno de chamada (d3dkmddi.h)
De um identificador de adaptador fornecido, DXGKDDI_GETNODEMETADATA retorna os metadados de um mecanismo em um nó de GPU especificado.
Sintaxe
DXGKDDI_GETNODEMETADATA DxgkddiGetnodemetadata;
NTSTATUS DxgkddiGetnodemetadata(
[in] IN_CONST_HANDLE hAdapter,
UINT NodeOrdinalAndAdapterIndex,
OUT_PDXGKARG_GETNODEMETADATA pGetNodeMetadata
)
{...}
Parâmetros
[in] hAdapter
[in] Um identificador que identifica um adaptador de exibição. Dxgkrnl anteriormente forneceu esse identificador para o KMD (driver de miniporto de exibição) no parâmetro DxgkInterface da funçãoDxgkDdiStartDevice.
NodeOrdinalAndAdapterIndex
[in] Um índice de um nó para o qual as informações do mecanismo são obtidas. Esse nó está dentro do adaptador físico definido pelo parâmetro hAdapter.
pGetNodeMetadata
[out] Ponteiro para uma estrutura DXGKARG_GETNODEMETADATA na qual KMD retorna os metadados do mecanismo especificados por NodeOrdinal.
Observe que a estrutura DXGKARG_GETNODEMETADATA é declarada como uma estrutura DXGK_NODEMETADATA.
Valor de retorno
Retorna um dos seguintes valores:
| Código de retorno | Descrição |
|---|---|
| STATUS_SUCCESS | DxgkDdiGetNodeMetadata recuperou com êxito as informações do mecanismo. |
| STATUS_INVALID_PARAMETER | O parâmetro hAdapter ou pGetNodeMetadata é inválido ou NodeOrdinal é maior ou igual ao número de nós no adaptador. |
Se os parâmetros hAdapter e pGetNodeMetadata forem válidos e NodeOrdinal tiver um valor no intervalo de 0 a (número de nós - 1), todas as chamadas para essa função deverão ser bem-sucedidas.
Observações
O KMD define os bits para cada recurso compatível com o nó de GPU especificado. O sistema operacional permite que a UMD use apenas os recursos de metadados para os quais o KMD relata suporte.
O WDDM 1.3 e os KMDs (drivers de miniporto) de exibição posterior devem implementar DXGKDDI_GETNODEMETADATA.
Para obter mais informações sobre como implementar essa função, consulte Enumerando recursos do mecanismo de GPU.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 8.1 (WDDM 1.3) |
| servidor com suporte mínimo | Windows Server 2012 R2 |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | d3dkmddi.h (inclua D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |