DXGKDDI_COLLECTDBGINFO Rückruffunktion (d3dkmddi.h)

Artikel
05/23/2024

Die DxgkDdiCollectDbgInfo-Funktion gibt Treiberinformationen für einen Debugbericht aus.

Syntax

DXGKDDI_COLLECTDBGINFO DxgkddiCollectdbginfo;

NTSTATUS DxgkddiCollectdbginfo(
  [in]     IN_CONST_HANDLE hAdapter,
  [in/out] IN_CONST_PDXGKARG_COLLECTDBGINFO pCollectDbgInfo
)
{...}

Parameter

[in] hAdapter

Ein Handle für einen Kontextblock, der einem Anzeigeadapter zugeordnet ist. Der Display-Miniport (KMD) hat dieses Handle zuvor für Dxgkrnl im Ausgabeparameter MiniportDeviceContext von DxgkDdiAddDevice bereitgestellt.

[in/out] pCollectDbgInfo

Ein Zeiger auf eine DXGKARG_COLLECTDBGINFO Struktur, die Informationen für den Debugbericht enthält.

Rückgabewert

DxgkDdiCollectDbgInfo gibt einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
STATUS_SUCCESS	DxgkDdiCollectDbgInfo gibt Treiberinformationen erfolgreich für einen Debugbericht aus. Oder das Betriebssystem ignorierte den Inhalt im Puffer, auf den pBuffer verweist, und hat dem Debugbericht keine Informationen aus DxgkDdiCollectDbgInfo hinzugefügt.
STATUS_NO_MEMORY	DxgkDdiCollectDbgInfo konnte keinen Speicher zuordnen, der für den Abschluss erforderlich war.
STATUS_UNSUCCESSFUL	Ein weiterer Fehler verhinderte, dass der Treiber gültige Debuginformationen sammelte.

Hinweise

Dxgkrnl ruft die DxgkDdiCollectDbgInfo-Funktion von KMD auf, wenn das Betriebssystem einen treiberbezogenen Debugbericht generieren möchte. DxgkDdiCollectDbgInfo kann entweder unmittelbar vor der Timeouterkennung und -wiederherstellung (Timeout Detection and Recovery, TDR) oder unmittelbar vor den Betriebssystemfehlerüberprüfungen aufgerufen werden. Obwohl DxgkDdiCollectDbgInfo so schnell wie möglich zurückgegeben werden sollte, gibt es keine systemdefinierte maximale Zeit, die der Treiber in dieser Funktion verbringen kann.

KMD sollte Debuginformationen sammeln. Wenn DxgkDdiCollectDbgInfo aufgerufen wird, empfängt der Treiber einen Fehlerüberprüfungscode in pCollectDbgInfo-Reason>, der den Typ der für den Debugbericht erforderlichen Informationen angibt. Der Treiber kopiert die erforderlichen Debuginformationen in den Puffer, auf den pCollectDbgInfo-pBuffer> verweist. Die maximale Anzahl von Bytes an Informationen, die der Treiber kopieren kann, wird von pCollectDbgInfo-BufferSize> angegeben.

DxgkDdiCollectDbgInfo wird in der Regel mit einem nicht definierten IRQL ausgeführt. Wenn pCollectDbgInfo-Reason> jedoch auf VIDEO_TDR_TIMEOUT_DETECTED (um eine adapterweite Zurücksetzung anzugeben) oder auf VIDEO_ENGINE_TIMEOUT_DETECTED (verfügbar ab Windows 8, um eine Zurücksetzung eines oder mehrerer Knoten innerhalb eines physischen Adapters anzugeben), muss der Treiber sicherstellen, dass DxgkDdiCollectDbgInfo auslagerungsfähig ist, mit IRQL = PASSIVE_LEVEL ausgeführt wird und die Synchronisierungsstufe Null unterstützt.