PFND3DDDI_GETPITCH função de retorno de chamada (d3dumddi.h)
A função GetPitch recupera o tom de uma superfície protegida ou não bloqueável.
Sintaxe
PFND3DDDI_GETPITCH Pfnd3dddiGetpitch;
HRESULT Pfnd3dddiGetpitch(
HANDLE hDevice,
D3DDDIARG_GETPITCH *unnamedParam2
)
{...}
Parâmetros
hDevice
Um identificador para o dispositivo de exibição (contexto gráfico).
unnamedParam2
pData [in, out]
Um ponteiro para uma estrutura D3DDDIARG_GETPITCH que descreve a superfície protegida.
Retornar valor
A função GetPitch retorna um dos seguintes valores:
| Código de retorno | Descrição |
|---|---|
| S_OK | O tom da superfície protegida é recuperado com êxito. |
| D3DDDIERR_NOTAVAILABLE | O driver não dá suporte à função GetPitch. |
Comentários
O hardware e os drivers podem, opcionalmente, dar suporte à função GetPitch .
A superfície para a qual a função GetPitch retorna o pitch pode ser não bloqueável ou protegida. Portanto, o aplicativo não pode recuperar o tom da superfície por meio de uma chamada para a função Lock do driver. O aplicativo deve recuperar o tom da superfície para alocar corretamente o buffer de memória do sistema que o aplicativo usa posteriormente em chamadas para as funções EncryptionBlt e DecryptionBlt do driver.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Há suporte para GetPitch a partir do sistema operacional Windows 7. |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | d3dumddi.h (inclua D3dumddi.h) |