estrutura DXGK_QUERYSEGMENTOUT3 (d3dkmddi.h)

Descreve informações de segmento de memória que um driver de miniportor WDDM (Modelo de Driver de Exibição do Windows) 1.2 ou posterior deve retornar de uma chamada para sua função DxgkDdiQueryAdapterInfo .

Sintaxe

typedef struct _DXGK_QUERYSEGMENTOUT3 {
  [out] UINT                    NbSegment;
  [out] DXGK_SEGMENTDESCRIPTOR3 *pSegmentDescriptor;
  [out] UINT                    PagingBufferSegmentId;
  [out] UINT                    PagingBufferSize;
  [out] UINT                    PagingBufferPrivateDataSize;
} DXGK_QUERYSEGMENTOUT3;

Membros

[out] NbSegment

O número de segmentos de memória aos quais o driver dá suporte.

[out] pSegmentDescriptor

Uma matriz de estruturas de DXGK_SEGMENTDESCRIPTOR3 que o driver preenche com informações sobre os segmentos compatíveis. O tamanho da matriz é o valor especificado por NbSegment .

[out] PagingBufferSegmentId

O identificador do segmento do qual o gerenciador de memória de vídeo deve alocar o buffer de paginação. Esse segmento deve ser um segmento de abertura.

[out] PagingBufferSize

O tamanho, em bytes, que o gerenciador de memória de vídeo deve alocar para o buffer de paginação.

[out] PagingBufferPrivateDataSize

O tamanho, em bytes, da estrutura de dados privados residente no driver associada a cada buffer de paginação. A memória dessa estrutura de dados privados é alocada do pool nãopagado. Se o driver especificar zero para PagingBufferPrivateDataSize, nenhuma memória será alocada para a estrutura de dados privados.

A estrutura de dados privados associada a um buffer de paginação é inicializada como zero quando o buffer de paginação é criado. Durante o tempo de vida do buffer de paginação, o gerenciador de memória de vídeo nunca acessa a estrutura de dados privada associada ao buffer de paginação.

Comentários

Essa estrutura é usada pelo driver de miniporto de exibição para retornar informações sobre segmentos de memória em resposta a uma chamada de função DxgkDdiQueryAdapterInfo na qual o subsistema gráfico especifica o valor DXGKQAITYPE_QUERYSEGMENT3 no membro Type da estrutura DXGKARG_QUERYADAPTERINFO .

O gerenciador de memória de vídeo aloca um buffer de paginação de um segmento de abertura (se o membro PagingBufferSegmentId identificar o segmento) ou como um bloco de memória contíguo combinado de gravação (se PagingBufferSegmentId estiver definido como 0). Se PagingBufferSegmentId estiver definido como 0, a GPU deverá acessar buffers de DMA (acesso direto à memória) usando ciclos PCI em sistemas em que as transferências de AGP que ocorrem fora da abertura do AGP não são permitidas.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8
Servidor mínimo com suporte	Windows Server 2012
Cabeçalho	d3dkmddi.h

Confira também

DXGKARG_QUERYADAPTERINFO

DXGK_QUERYSEGMENTIN

DXGK_SEGMENTDESCRIPTOR3

DxgkDdiQueryAdapterInfo