PDXGK_INITIAL_COMPONENT_STATE Rückruffunktion (d3dkmthk.h)
Die PDXGK_INITIAL_COMPONENT_STATE Rückruffunktion wird vom Clienttreiber implementiert, um den Komponentenstatus zu initialisieren.
Syntax
PDXGK_INITIAL_COMPONENT_STATE PdxgkInitialComponentState;
void PdxgkInitialComponentState(
PVOID GraphicsDeviceHandle,
PVOID PrivateHandle,
ULONG ComponentIndex,
BOOLEAN IsBlockingType,
UINT InitialFState,
GUID ComponentGuid,
UINT PowerComponentMappingFlag
)
{...}
Parameter
GraphicsDeviceHandle
Ein Handle für das Grafikgerät.
PrivateHandle
Ein undurchsichtiges Handle, das in Rückrufen bereitgestellt wird. Dieses Handle muss global eindeutig sein, daher sollte ein Zeiger auf die PDO oder FDO des aufrufenden Treibers verwendet werden.
ComponentIndex
Der Index der Komponente. Im Allgemeinen ist dies der Index, der vom Grafikkarten verwendet wird. Die Ausnahme gilt für LDA-Szenarien (Linked Display Adapter), in denen das HIWORD des ComponentIndex den Adapterindex angibt, wie dies geschieht, wenn der Grafiktreiber vom Grafikkern für F-Zustandsänderungen in LDA-Szenarien aufgerufen wird.
IsBlockingType
Legen Sie TRUE fest, wenn die Komponente "blockiert" ist. Beispielsweise hat der Grafiktreiber die Komponente als ActiveInD3 = 0 gemeldet. Legen Sie andernfalls FALSE fest.
InitialFState
Der F-Zustand einer Komponente, die von ComponentIndex zum Zeitpunkt des Aufrufs dargestellt wird. Wenn derzeit ein F-Zustandsübergang ausgeführt wird, folgt nach Abschluss des Übergangs einige Zeit später ein PDXGK_FSTATE_NOTIFICATION Abschlussbenachrichtigungsrückruf mit PreNotification=FALSE . Je nach Zeitpunkt kann es zu einem PreNotification=TRUE Rückruf kommen. Wenn dies der Fall ist, wird der Rückruf der Vervollständigungsbenachrichtigung vorangestellt.
ComponentGuid
Ein GUID-Wert, bei dem es sich um die Komponenten-GUID handelt, die vom Grafiktreiber für diese Komponente während der DXGKQAITYPE_POWERCOMPONENTINFO Antwort gemeldet wird.
PowerComponentMappingFlag
Das HIWORD gibt an, ob es sich um einen benutzerdefinierten Treiber definierten Wert handelt (0 = nein, 1 = ja). Wenn 0 (nein) ist, stellt das niedrige Wort einen DXGKMT_POWER_SHARED_TYPE Enumerationswert dar. Diese Werte werden vom Grafiktreiber während seiner DXGKQAITYPE_POWERCOMPONENTINFO-Antwort unter Verwendung des DXGK_POWER_COMPONENT_SHARED_DESC-Typs festgelegt, der DXGK_POWER_COMPONENT_MAPPING hinzugefügt wurde.
Rückgabewert
Keine
Bemerkungen
Wenn bei der Registrierung des freigegebenen Stroms (IoCallDriver-Aufruf ) PDXGK_INITIAL_COMPONENT_STATE angegeben wurde, wird es für jede freigegebene Energiekomponente, die vom Grafiktreiber gemeldet wurde, einmal aufgerufen. Das Verhalten dieses Rückrufs ist so, dass:
- Bei diesen Aufrufen handelt es sich um Wiederholungsaufrufe, die vor der IoCallDriver-Rückgabe auftreten.
- Diese Aufrufe erfolgen bei DISPATCH_LEVEL, sodass Treibercode und Daten speicherresident sein müssen.
- Da diese Rückrufe vor der IoCallDriver-Rückgabe erfolgen, wären DXGK_GRAPHICSPOWER_REGISTER_OUTPUT noch nicht ausgefüllt worden.
- Wenn derzeit F-Zustandsübergänge ausgeführt werden, benachrichtigt ein PDXGK_FSTATE_NOTIFICATION nach der Benachrichtigung den Treiber über den endgültigen Zustand. Solche Aufrufe werden nach den InitialComponentStateCb-Aufrufen garantiert. Es ist jedoch möglich, dass solche Rückrufe auftreten können, bevor IoCallDriver zurückgegeben wird, wenn eine Synchronisierung erforderlich ist. Eine Spinsperre sollte sich um IoCallDriver und den PDXGK_FSTATE_NOTIFICATION-Handlers herum bewegen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 |
| Unterstützte Mindestversion (Server) | Windows Server 2012 |
| Kopfzeile | d3dkmthk.h |
| IRQL | DISPATCH_LEVEL |