Поделиться через


функция обратного вызова 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 возвращает шаг, может быть неблокируемой или защищенной. Поэтому приложение не может получить шаг поверхности с помощью вызова функции Lock драйвера. Приложение должно получить шаг поверхности, чтобы правильно выделить буфер системной памяти, который приложение впоследствии использует в вызовах функций EncryptionBlt и DecryptionBlt драйвера.

Требования

Требование Значение
Минимальная версия клиента GetPitch поддерживается начиная с операционной системы Windows 7.
Целевая платформа Персональный компьютер
Верхняя часть d3dumddi.h (включая D3dumddi.h)

См. также раздел

D3DDDIARG_GETPITCH

DecryptionBlt

EncryptionBlt