функция обратного вызова PFND3DDDI_GETPITCH (d3dumddi.h)
Функция GetPitch извлекает поле защищенной или неблокируемой поверхности.
Синтаксис
PFND3DDDI_GETPITCH Pfnd3dddiGetpitch;
HRESULT Pfnd3dddiGetpitch(
HANDLE hDevice,
D3DDDIARG_GETPITCH *unnamedParam2
)
{...}
Параметры
hDevice
Дескриптор устройства отображения (графический контекст).
unnamedParam2
pData [in, out]
Указатель на структуру D3DDDIARG_GETPITCH, описывающую защищенную поверхность.
Возвращаемое значение
Функция GetPitch возвращает одно из следующих значений:
| Возвращаемый код | Описание |
|---|---|
| S_OK | Шаг защищенной поверхности успешно извлекается. |
| D3DDDIERR_NOTAVAILABLE | Драйвер не поддерживает функцию GetPitch. |
Замечания
Оборудование и драйверы также могут поддерживать функцию GetPitch.
Поверхность, для которой функция GetPitch возвращает поле, может быть неблокировано или защищено. Поэтому приложение не может получить шаг поверхности через вызов функции блокировки драйвера. Приложение должно получить шаг поверхности, чтобы правильно выделить буфер памяти системы, который приложение впоследствии использует в вызовах EncryptionBlt драйвера и DecryptionBlt функций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | GetPitch поддерживается начиная с операционной системы Windows 7. |
| целевая платформа | Настольный |
| заголовка | d3dumddi.h (include D3dumddi.h) |