estrutura DD_GETDRIVERINFODATA (ddrawint.h)

A estrutura DD_GETDRIVERINFODATA é usada para passar dados de e para a rotina de retorno de chamada DdGetDriverInfo .

Sintaxe

typedef struct _DD_GETDRIVERINFODATA {
  VOID    *dhpdev;
  DWORD   dwSize;
  DWORD   dwFlags;
  GUID    guidInfo;
  DWORD   dwExpectedSize;
  PVOID   lpvData;
  DWORD   dwActualSize;
  HRESULT ddRVal;
} *PDD_GETDRIVERINFODATA, DD_GETDRIVERINFODATA;

Membros

dhpdev

Identificador para o PDEV do driver. Somente o Microsoft Windows 2000 e posterior.

dwSize

Especifica o tamanho em bytes dessa estrutura DD_GETDRIVERINFODATA.

dwFlags

Atualmente não utilizado e está definido como zero.

guidInfo

Especifica o GUID do suporte do Microsoft DirectX para o qual o driver está sendo consultado. Em um driver Do Microsoft DirectDraw do Windows 2000 e posterior, esse membro pode ser um dos seguintes valores (em ordem alfabética):

GUID	Descrição
GUID_ColorControlCallbacks	Consulta se o driver dá suporte a DdControlColor. Se o driver der suporte a ele, o driver deverá inicializar e retornar uma estrutura DD_COLORCONTROLCALLBACKS no buffer para o qual lpvData aponta.
GUID_D3DCallbacks	Consulta se o driver dá suporte a qualquer uma das funcionalidades especificadas por meio da estrutura D3DHAL_CALLBACKS . Se o driver não fornecer nenhum desse suporte, ele deverá inicializar e retornar uma estrutura D3DHAL_CALLBACKS no buffer para o qual lpvData aponta.
GUID_D3DCallbacks2	Obsoleto.
GUID_D3DCallbacks3	Consulta se o driver dá suporte a qualquer uma das funcionalidades especificadas por meio da estrutura D3DHAL_CALLBACKS3 . Se o driver fornecer qualquer um desses suportes, ele deverá inicializar e retornar uma estrutura D3DHAL_CALLBACKS3 no buffer para o qual lpvData aponta.
GUID_D3DCaps	Obsoleto.
GUID_D3DExtendedCaps	Consulta se o driver dá suporte a qualquer uma das funcionalidades do Microsoft Direct3D especificadas por meio da estrutura D3DHAL_D3DEXTENDEDCAPS . Se o driver fornecer qualquer um desses suportes, ele deverá inicializar e retornar uma estrutura D3DHAL_D3DEXTENDEDCAPS no buffer para o qual o lpvData aponta.
GUID_D3DParseUnknownCommandCallback	Fornece a parte Direct3D do driver com D3dParseUnknownCommandCallback do runtime do Direct3D. O retorno de chamada D3dDrawPrimitives2 do driver chama D3dParseUnknownCommandCallback para analisar comandos do buffer de comando que o driver não entende. DirectDraw passa um ponteiro para essa função no buffer para o qual lpvData aponta. Se o driver der suporte a esse aspecto do Direct3D, ele deverá armazenar o ponteiro.
GUID_GetHeapAlignment	Consulta se o driver dá suporte a requisitos de alinhamento de superfície por heap. Se o driver fornecer esse suporte, ele deverá inicializar e retornar uma estrutura DD_GETHEAPALIGNMENTDATA no buffer para o qual lpvData aponta.
GUID_KernelCallbacks	Consulta se o driver dá suporte a qualquer uma das funcionalidades especificadas por meio da estrutura DD_KERNELCALLBACKS . Se o driver fornecer qualquer um desses suportes, ele deverá inicializar e retornar uma estrutura DD_KERNELCALLBACKS no buffer para o qual lpvData aponta.
GUID_KernelCaps	Consulta se o driver dá suporte a qualquer um dos recursos de modo kernel especificados por meio da estrutura DDKERNELCAPS . Se o driver fornecer qualquer um desses suportes, ele deverá inicializar e retornar uma estrutura DDKERNELCAPS no buffer para o qual lpvData aponta.
GUID_MiscellaneousCallbacks	Consulta se o driver dá suporte a DdGetAvailDriverMemory. Se o driver der suporte a ele, o driver deverá inicializar e retornar uma estrutura DD_MISCELLANEOUSCALLBACKS no buffer para o qual o lpvData aponta.
GUID_Miscellaneous2Callbacks	Consulta se o driver dá suporte à funcionalidade diversa adicional especificada na estrutura DD_MISCELLANEOUS2CALLBACKS . Se o driver der suporte a qualquer um desses suportes, o driver deverá inicializar e retornar uma estrutura DD_MISCELLANEOUS2CALLBACKS no buffer para o qual o lpvData aponta.
GUID_MotionCompCallbacks	Consulta se o driver dá suporte à funcionalidade de compensação de movimento especificada por meio da estrutura DD_MOTIONCOMPCALLBACKS . Se o driver fornecer qualquer um desses suportes, deverá inicializar e retornar uma estrutura DD_MOTIONCOMPCALLBACKS no buffer para o qual lpvData aponta.
GUID_NonLocalVidMemCaps	Consulta se o driver dá suporte a qualquer um dos recursos de memória de exibição não local especificados por meio da estrutura DD_NONLOCALVIDMEMCAPS . Se o driver fornecer qualquer um desses suportes, ele deverá inicializar e retornar uma estrutura DD_NONLOCALVIDMEMCAPS no buffer para o qual lpvData aponta.
GUID_NTCallbacks	Consulta se o driver dá suporte a qualquer uma das funcionalidades especificadas por meio da estrutura DD_NTCALLBACKS . Se o driver fornecer qualquer um desses suportes, ele deverá inicializar e retornar uma estrutura DD_NTCALLBACKS no buffer para o qual lpvData aponta.
GUID_NTPrivateDriverCaps	Consulta se o driver dá suporte às técnicas de criação de superfície no estilo Windows 98/Me especificadas por meio da estrutura DD_NTPRIVATEDRIVERCAPS . Se o driver fornecer qualquer um desses suportes, ele deverá inicializar e retornar uma estrutura DD_NTPRIVATEDRIVERCAPS no buffer para o qual lpvData aponta.
GUID_UpdateNonLocalHeap	Consulta se o driver dá suporte à recuperação dos endereços base de cada heap não local por sua vez. Se o driver fornecer esse suporte, ele deverá inicializar e retornar uma estrutura DD_UPDATENONLOCALHEAPDATA no buffer para o qual lpvData aponta.
GUID_VideoPortCallbacks	Consulta se o driver dá suporte às VPE (extensões de porta de vídeo). Se o driver der suporte à VPE, ele deverá inicializar e retornar uma estrutura DD_VIDEOPORTCALLBACKS no buffer para o qual lpvData aponta.
GUID_VideoPortCaps	Consulta se o driver dá suporte a qualquer um dos recursos de objeto VPE especificados por meio da estrutura DDVIDEOPORTCAPS . Se o driver fornecer qualquer um desses suportes, ele deverá inicializar e retornar uma estrutura DDVIDEOPORTCAPS no buffer para o qual lpvData aponta.
GUID_ZPixelFormats	Consulta os formatos de pixel compatíveis com o buffer de profundidade. Se o driver der suporte ao Direct3D, ele deverá alocar e inicializar os membros apropriados de uma estrutura DDPIXELFORMAT para cada formato de buffer z compatível e retorná-los no buffer para o qual o lpvData aponta.

dwExpectedSize

Especifica o número de bytes de dados que o DirectDraw espera que o driver passe de volta no buffer para o qual lpvData aponta.

lpvData

Aponta para um buffer alocado pelo DirectDraw no qual o driver copia os dados solicitados. Esse buffer normalmente é dwExpectedSize bytes de tamanho. O driver não deve gravar mais do que dwExpectedSize bytes de dados nele. O driver especifica o número de bytes que ele grava nesse buffer no membro dwActualSize .

dwActualSize

Especifica o local em que o driver retorna o número de bytes de dados que grava em lpvData.

ddRVal

Especifica o local em que o driver grava o valor retornado do retorno de chamada DdGetDriverInfo . Um código de retorno de DD_OK indica êxito. Para obter mais informações, consulte Valores retornados para DirectDraw.

Comentários

A estrutura de dados passada para o driver para uma chamada DdGetDriverInfo tem pequenas diferenças entre o Windows 98/Me e o Windows 2000 e posterior. No Windows 2000 e posterior, a estrutura de dados é chamada DD_GETDRIVERINFODATA e, no Windows 98/Me, a estrutura de dados é chamada de DDHAL_GETDRIVERINFODATA. Ambas as estruturas de dados incluem um campo para informações de contexto específicas do driver. No Windows 2000 e posterior, DD_GETDRIVERINFODATA inclui um campo dhpdev que armazena o DHPDEV do driver que está sendo chamado. Somente no Windows 98/Me, DDHAL_GETDRIVERINFODATA inclui um campo dwContext que é copiado para o campo dwReserved3 reservado do driver do objeto global DirectDraw.

Requisitos

Requisito	Valor
Cabeçalho	ddrawint.h (inclua Winddi.h)

Confira também

DdGetDriverInfo