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) |