DXGK_FIRMWARE_TABLE_INTERFACE structure (dispmprt.h)
Contains functions that user-mode display drivers can use to read and enumerate the system firmware table. These functions are supplied by the Microsoft DirectX graphics kernel subsystem and can be called by WDDM 1.2 and later user-mode display drivers.
Syntax
typedef struct _DXGK_FIRMWARE_TABLE_INTERFACE {
USHORT Size;
USHORT Version;
PVOID Context;
PINTERFACE_REFERENCE InterfaceReference;
PINTERFACE_DEREFERENCE InterfaceDereference;
NTSTATUS(VOID *Context,ULONG ProviderSignature,ULONG BufferSize,VOID *Buffer,ULONG *RequiredSize) * )(EnumSystemFirmwareTables;
NTSTATUS(VOID *Context,ULONG ProviderSignature,ULONG TableId,ULONG BufferSize,VOID *Buffer,ULONG *RequiredSize) * )(ReadSystemFirmwareTable;
} DXGK_FIRMWARE_TABLE_INTERFACE, *PDXGK_FIRMWARE_TABLE_INTERFACE;
Members
Size
The size, in bytes, of this structure.
Version
The version number of the System Firmware Table interface. Version number constants are defined in Dispmprt.h (for example, DXGK_FIRMWARE_TABLE_INTERFACE_VERSION_1).
Context
A pointer to a context that is provided by the display port driver.
InterfaceReference
A pointer to an interface reference function that is implemented by the display port driver.
InterfaceDereference
A pointer to an interface dereference function that is implemented by the display port driver.
EnumSystemFirmwareTables
Enumerates the system firmware table. All input parameters are supplied by the display miniport driver.
Syntax:
NTSTATUS EnumSystemFirmwareTables(
_In_ VOID *Context,
_In_ ULONG ProviderSignature,
_In_ ULONG TableId,
_In_ ULONG BufferSize,
_Out_opt_ VOID *Buffer,
_Out_ ULONG *RequiredSize
);
The raw SMBIOS table provider ('RSMB') currently returns a single table identifier, 0x0000. This corresponds to the raw SMBIOS firmware table.
The raw firmware table provider ('FIRM') returns a list of DWORD table identifiers. Each identifier corresponds to the beginning of a physical address range. Currently, this provider returns 'C0000' and 'E0000'. These values correspond to physical memory from 0xC0000 to 0xDFFFF and 0xE0000 to 0xFFFFF, respectively.
The ACPI table provider ('ACPI') returns a list of DWORD table identifiers. Each identifier returned corresponds to the Signature member of the DESCRIPTION_HEADER structure for an ACPI table currently in the ACPI namespace of the system.
For ACPI, if the system contains multiple tables with the same name, they are all enumerated with EnumSystemFirmwareTables. However, ReadSystemFirmwareTable retrieves only the first table in the list with this name.
Context
A handle to a context block that is associated with a display adapter. The display miniport driver's DxgkDdiAddDevice function previously provided this handle to the DirectX graphics kernel subsystem.
ProviderSignature
The identifier of the firmware table provider to which the query is to be directed. This parameter can be one of the following values.
| Value | Meaning |
|---|---|
| 'ACPI' | The ACPI firmware table provider. |
| 'FIRM' | The raw firmware table provider. |
| 'RSMB' | The raw SMBIOS firmware table provider. |
TableId
The identifier of the firmware table. This identifier is in little-endian format, so you must reverse the characters in the string.
For example, FACP is an ACPI provider, as described in the Signature member of the DESCRIPTION_HEADER structure in the ACPI specification. Therefore, use 'PCAF' to specify the FACP table, as shown in the following example:
retVal = ReadSystemFirmwareTable('ACPI', 'PCAF', pBuffer, BUFSIZE);
BufferSize
The size of the buffer pointed to by the Buffer parameter, in bytes.
Buffer
An optional pointer to a buffer that receives the list of firmware tables. If this parameter is NULL, the return value is the required buffer size.
For more information on the contents of this buffer, see the Remarks section.
RequiredSize
A pointer to a value that receives the minimum size of the buffer pointed to by Buffer, in bytes, that the operating system needs to process the enumeration request.
ReadSystemFirmwareTable
Reads the system firmware table. All input parameters are supplied by the display miniport driver.
NTSTATUS ReadSystemFirmwareTable(
_In_ VOID *Context,
_In_ ULONG ProviderSignature,
_In_ ULONG TableId,
_In_ ULONG BufferSize,
_Out_opt_ VOID *Buffer,
_Out_ ULONG *RequiredSize
);
The raw SMBIOS table provider ('RSMB') retrieves the contents of the raw SMBIOS firmware table. The buffer pointed to by the Buffer parameter receives the following data:
#include <windows.h>
struct RawSMBIOSData
{
BYTE Used20CallingMethod;
BYTE SMBIOSMajorVersion;
BYTE SMBIOSMinorVersion;
BYTE DmiRevision;
DWORD Length;
BYTE SMBIOSTableData[];
};
The raw firmware table provider ('FIRM') retrieves the contents of the specified physical address range. ReadSystemFirmwareTable returns the size of the address range.
The ACPI table provider ('ACPI') retrieves the contents of the specified ACPI table. Because OEMs can include ACPI firmware tables that are not listed in the ACPI specification, you should first call the EnumSystemFirmwareTables function to enumerate all ACPI tables that are currently on the system.
For ACPI, if the system contains multiple tables with the same name, they are all enumerated with EnumSystemFirmwareTables. However, ReadSystemFirmwareTable retrieves only the first table in the list with this name.
Context
A handle to a context block that is associated with a display adapter. The display miniport driver's DxgkDdiAddDevice function previously provided this handle to the DirectX graphics kernel subsystem.
ProviderSignature
The identifier of the firmware table provider to which the query is to be directed. This parameter can be one of the following values.
| Value | Meaning |
|---|---|
| 'ACPI' | The ACPI firmware table provider. |
| 'FIRM' | The raw firmware table provider. |
| 'RSMB' | The raw SMBIOS firmware table provider. |
TableId
The identifier of the firmware table. This identifier is in little-endian format, so you must reverse the characters in the string.
For example, FACP is an ACPI provider, as described in the Signature member of the DESCRIPTION_HEADER structure in the ACPI specification. Therefore, use 'PCAF' to specify the FACP table, as shown in the following example:
retVal = ReadSystemFirmwareTable('ACPI', 'PCAF', pBuffer, BUFSIZE);
BufferSize
The size of the buffer pointed to by the Buffer parameter, in bytes.
Buffer
An optional pointer to a buffer that receives the requested firmware table. If this parameter is NULL, the return value is the required buffer size.
For more information on the contents of this buffer, see the Remarks section.
RequiredSize
A pointer to a value that receives the minimum size of the buffer pointed to by Buffer, in bytes, that the operating system needs to process the read request.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 8 |
| Minimum supported server | Windows Server 2012 |
| Header | dispmprt.h (include Dispmprt.h) |