структура DXGK_SPB_INTERFACE (dispmprt.h)

Структура DXGK_SPB_INTERFACE содержит указатели на функции в интерфейсе простой периферийной шины (SPB), которую может вызывать драйвер windows Display Driver Model (WDDM) 1.2 и более поздних версий для проверки и изменения ресурсов SPB.

Синтаксис

typedef struct _DXGK_SPB_INTERFACE {
  USHORT                 Size;
  USHORT                 Version;
  PVOID                  Context;
  PINTERFACE_REFERENCE   InterfaceReference;
  PINTERFACE_DEREFERENCE InterfaceDereference;
  NTSTATUS(HANDLE DeviceHandle,LARGE_INTEGER SpbReourceId,UNICODE_STRING *SpbResourceSubName,ACCESS_MASK DesiredAccess,ULONG ShareAccess,ULONG OpenOptions,VOID **SpbResource)              * )(OpenSpbResource;
  NTSTATUS()(HANDLE DeviceHandle,VOID *SpbResource)              * CloseSpbResource;
  NTSTATUS(ANDLE DeviceHandle,VOID *SpbResource,ULONG Length,VOID *Buffer,LARGE_INTEGER *ByteOffset,HANDLE EventHandle,IO_STATUS_BLOCK *IoStatusBlock)              * )(HReadSpbResource;
  NTSTATUS(ANDLE DeviceHandle,VOID *SpbResource,ULONG Length,VOID *Buffer,LARGE_INTEGER *ByteOffset,HANDLE EventHandle,IO_STATUS_BLOCK *IoStatusBlock)              * )(HWriteSpbResource;
  NTSTATUS(ANDLE DeviceHandle,VOID *SpbResource,ULONG IoControlCode,ULONG InBufferSize,VOID *InputBuffer,ULONG OutBufferSize,VOID *OutputBuffer,HANDLE EventHandle,IO_STATUS_BLOCK *IoStatusBlock)              * )(HSpbResourceIoControl;
} DXGK_SPB_INTERFACE, *PDXGK_SPB_INTERFACE;

Члены

Size

Размер данной структуры (в байтах).

Version

Номер версии интерфейса SPB. Константы номеров версий определяются в Dispmprt.h (например, DXGK_SPB_INTERFACE_VERSION_1).

Context

Указатель на контекст, предоставляемый драйвером мини-порта дисплея.

InterfaceReference

Указатель на функцию ссылки на интерфейс, реализованную драйвером мини-порта дисплея.

InterfaceDereference

Указатель на функцию разыменования интерфейса, реализованную драйвером мини-порта дисплея.

OpenSpbResource

Открывает ресурс простой периферийной шины (SPB). Все входные параметры предоставляются драйвером мини-порта дисплея.

CloseSpbResource

Закрывает ресурс SPB. Все входные параметры предоставляются драйвером мини-порта дисплея.

Закрытие дескриптора открытого объекта приводит к тому, что этот дескриптор становится недействительным. Система также уменьшает количество дескрипторов для объекта и проверяет, можно ли удалить объект. Система фактически не удаляет объект до тех пор, пока все дескрипторы объекта не будут закрыты, а указатели на них не остаются.

Драйвер должен вызвать CloseSpbResource , чтобы закрыть каждый дескриптор, открытый с помощью OpenSpbResource , как только дескриптор больше не требуется.

Вызывающие методы CloseSpbResource не должны предполагать, что эта функция автоматически ожидает завершения всех операций ввода-вывода перед возвратом.

ReadSpbResource

Считывает данные из открытого ресурса SPB. Все входные параметры предоставляются драйвером мини-порта дисплея.

Если при вызове OpenSpbResource задан любой из флагов OpenOptionsFILE_SYNCHRONOUS_IO_ALERT или FILE_SYNCHRONOUS_IO_NONALERT (определенный в Wdm.h), диспетчер операций ввода-вывода сохраняет текущую позицию файла. В этом случае вызывающий объект ReadSpbResource может указать, что вместо явного значения ByteOffset используется смещение текущей позиции файла. Эту спецификацию можно сделать с помощью одного из следующих методов:

• Укажите указатель на значение LARGE_INTEGER с элементом HighPart , равным -1, а элемент LowPart — на системное значение FILE_USE_FILE_POINTER_POSITION (определенное в Wdm.h).
• Передайте указатель NULL для ByteOffset.

ReadSpbResource обновляет текущую позицию файла, добавляя количество байтов, считанных по завершении операции чтения, если используется текущая позиция файла, поддерживаемая диспетчером ввода-вывода.

Даже если диспетчер операций ввода-вывода сохраняет текущую позицию файла, вызывающий объект может сбросить эту позицию, передав явное значение ByteOffsetв ReadSpbResource. Это автоматически изменяет текущую позицию файла на это значение ByteOffset , выполняет операцию чтения, а затем обновляет позицию в соответствии с количеством фактически прочитанных байтов. Этот метод предоставляет вызывающей объекту атомарную службу поиска и чтения.

WriteSpbResource

Записывает данные в открытый ресурс SPB.

Если вызов функции OpenSpbResource задает только флаг DesiredAccessFILE_APPEND_DATA, параметр ByteOffset игнорируется. В этом случае данные в буфере, на который указывает параметр Buffer для байтов длины , записываются, начиная с текущего конца файла.

Если при вызове OpenSpbResource задан любой из флагов CreateOptions , FILE_SYNCHRONOUS_IO_ALERT или FILE_SYNCHRONOUS_IO_NONALERT, диспетчер ввода-вывода сохраняет текущую позицию файла. Если это так, вызывающий объект WriteSpbResource может указать, что вместо явного значения ByteOffset используется текущее смещение позиции файла. Эту спецификацию можно сделать с помощью одного из следующих методов:

• Укажите указатель на значение LARGE_INTEGER с элементом HighPart , равным -1, а для элемента LowPart — системное значение , FILE_USE_FILE_POINTER_POSITION (определенное в Wdm.h).
• Передайте указатель NULL для ByteOffset.

WriteSpbResource обновляет текущую позицию файла, добавляя количество байтов, записанных при завершении операции записи, если используется текущая позиция файла, поддерживаемая диспетчером ввода-вывода.

Даже если диспетчер ввода-вывода сохраняет текущую позицию файла, вызывающий объект может сбросить эту позицию, передав явное значение ByteOffsetв WriteSpbResource. Это автоматически изменяет текущую позицию файла на это значение ByteOffset , выполняет операцию записи, а затем обновляет позицию в соответствии с фактически записанным числом байтов. Этот метод предоставляет вызывающей объекту атомарную службу поиска и записи.

Кроме того, можно вызвать запуск операции записи в текущем конце файла, указав для ByteOffset указатель на LARGE_INTEGER значение, если HighPart имеет значение -1, а LowPart — FILE_WRITE_TO_END_OF_FILE. Это работает независимо от того, поддерживает ли диспетчер ввода-вывода текущую позицию файла.

SpbResourceIoControl

Выполняет операцию управления вводом-выводом для открытого ресурса простой периферийной шины (SPB). Все входные параметры предоставляются драйвером мини-порта дисплея.

Если вызывающий объект открыл файл для асинхронного ввода-вывода (без FILE_SYNCHRONOUS_XXX набора параметров create/open), указанное событие, если таковое есть, будет установлено в состояние Signaled после завершения операции управления устройством. В противном случае объект файла, указанный параметром DeviceHandle , будет установлен в состояние Signaled .

Комментарии

Чтобы использовать функции этой структуры, сначала укажите элементы Size и Versionструктуры DXGK_SPB_INTERFACE . Затем вызовите функцию DxgkCbQueryServices , присвоив параметру ServicesType значение DxgkServicesFirmwareTable, а для параметра Interface задайте адрес (приведение к PINTERFACE) структуры DXGK_SPB_INTERFACE .

Дополнительные сведения об архитектуре SPB см. в разделе Simple PeripheralBus and SPB Peripheral Driver Design Guide**.

Требования