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 forneceu anteriormente esse identificador para o KMD (driver de miniporto de exibição) no parâmetro DxgkInterface da função DxgkDdiStartDevice .
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 o KMD retorna os metadados do mecanismo especificado por NodeOrdinal.
Observe que a estrutura DXGKARG_GETNODEMETADATA é declarada como uma estrutura DXGK_NODEMETADATA .
Retornar valor
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.
Comentários
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 miniporta de exibição) posteriores 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 |
|---|---|
| Cliente mínimo com suporte | Windows 8.1 (WDDM 1.3) |
| Servidor mínimo com suporte | Windows Server 2012 R2 |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | d3dkmddi.h (inclua D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |