Previous

Next

Function RTACPIGetStructure

RTACPIGetStructure retries an ACPI table with a specific signature:

const void * RTACPIGetStructure(DWORD Signature, int Index);

Parameters

Signature

Specifies the table's 32-bit signature. If the signature is expressed as 4 characters. macro RTACPISIG() must be used to ensure correct byte ordering. For example, signature RTACPISIG('FACP') would retrieve structure RTACPI_FACP.

Index

1-based index of the structure of type Signature to return. Some structure types may appear several times.

return value

A pointer to the requested structure or NULL if no such structure was found.

Signature value 0 can be used to retrieve the ACPI-internal Root System Description Pointer Structure.

Example:

const RTACPI_FACP * FACPPtr = 
   (const RTACPI_FACP *) RTACPIGetStructure(RTACPISIG('FACP'), 1); 

if (FACPPtr) 
   printf("\nACPI FACP structure found!\n");

Advanced Configuration and Power Interface (ACPI) Tables

Function RTACPIIsValid