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 [dentro, fora]
Um ponteiro para uma estrutura D3DDDIARG_GETPITCH que descreve a superfície protegida.
Valor de retorno
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. |
Observações
O hardware e os drivers podem, opcionalmente, dar suporte à função GetPitch.
A superfície para a qual a função GetPitch retorna o tom 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 do driver e DecryptionBlt.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | O GetPitch tem suporte a partir do sistema operacional Windows 7. |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | d3dumddi.h (inclua D3dumddi.h) |