функция обратного вызова PINT10_ALLOCATE_BUFFER (video.h)

  • Статья

Функцию Int10AllocateBuffer можно использовать для выделения одного блока памяти размером 4 КБ в контексте другого потока. После выделения блока памяти его необходимо освободить, прежде чем можно будет выделить другой блок памяти.

Синтаксис

PINT10_ALLOCATE_BUFFER Pint10AllocateBuffer;

VP_STATUS Pint10AllocateBuffer(
  [in]      IN PVOID Context,
  [out]     OUT PUSHORT Seg,
  [out]     OUT PUSHORT Off,
  [in, out] IN OUT PULONG Length
)
{...}

Параметры

[in] Context

Указатель на определенный драйвером видеопорта контекст для интерфейса. Это значение должно совпадать со значением в элементе Context структуры VIDEO_PORT_INT10_INTERFACE после возврата VideoPortQueryServices .

[out] Seg

Указатель на расположение памяти, которое получит адрес сегмента выделенного буфера памяти.

[out] Off

Указатель на расположение памяти, которое получит смещение в сегменте выделенного буфера памяти, заданном параметром *Seg.

[in, out] Length

Указатель на расположение памяти, содержащее длину запрошенного буфера памяти в байтах, которая может быть равна 4096. При возврате функции это расположение памяти будет содержать значение 4096, независимо от того, была ли выделена память на самом деле.

Возвращаемое значение

Функция Int10AllocateBuffer возвращает NO_ERROR при успешном выполнении. Он возвращает STATUS_INSUFFICIENT_RESOURCES, если буфер был выделен ранее или если запрашивается размер буфера больше 4096 байт.

Комментарии

Видеопорт реализует эту функцию, доступ к которой можно получить через указатель в структуре VIDEO_PORT_INT10_INTERFACE .

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows 2000 и более поздних версиях операционных систем Windows.
Целевая платформа Персональный компьютер
Верхняя часть video.h (включить Video.h)
IRQL PASSIVE_LEVEL

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

VIDEO_PORT_INT10_INTERFACE