DXGKDDI_OPENALLOCATIONINFO Rückruffunktion (d3dkmddi.h)

Artikel
02/06/2025

Die DxgkDdiOpenAllocation--Funktion bindet nicht gerätespezifische Zuordnungen, die vom DxgkDdiCreateAllocation-Funktion erstellt wurden, um Zuordnungen zuzuordnen, die für das angegebene Grafikkontextgerät spezifisch sind.

Syntax

DXGKDDI_OPENALLOCATIONINFO DxgkddiOpenallocationinfo;

NTSTATUS DxgkddiOpenallocationinfo(
  [in] IN_CONST_HANDLE hDevice,
  [in] IN_CONST_PDXGKARG_OPENALLOCATION pOpenAllocation
)
{...}

Parameter

[in] hDevice

Ein Handle für das Grafikkontextgerät, von dem die Zuordnungen gebunden sind. Die DxgkDdiCreateDevice-Funktion des Anzeige-Miniporttreibers stellt dieses Handle zuvor dem Microsoft DirectX-Grafik-Kernelsubsystem im hDevice Member der DXGKARG_CREATEDEVICE Struktur zur Verfügung.

[in] pOpenAllocation

Ein Zeiger auf eine DXGKARG_OPENALLOCATION Struktur, die Informationen zu Bindungszuordnungen enthält.

Rückgabewert

DxgkDdiOpenAllocation gibt einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
STATUS_SUCCESS	DxgkDdiOpenAllocation gebunden erfolgreich Zuordnungen an das Grafikkontextgerät, das der angegebene hDevice-Parameter angegeben hat.
STATUS_INVALID_PARAMETER	Parameter, die an DxgkDdiOpenAllocation übergeben wurden, enthielt Fehler, die das Abschließen verhinderten.
STATUS_NO_MEMORY	DxgkDdiOpenAllocation konnte keinen Speicher zuordnen, der für den Abschluss erforderlich war.
STATUS_GRAPHICS_DRIVER_MISMATCH	Der Miniporttreiber für die Anzeige ist nicht kompatibel mit dem Anzeigetreiber für den Benutzermodus, der den Aufruf von DxgkDdiOpenAllocation initiiert hat (d. a. private Daten an den Anzeigeminiporttreiber bereitgestellt).

Bemerkungen

Das DirectX-Grafik-Kernelsubsystem ruft die dxgkDdiOpenAllocation-Funktion des Anzeigeminiporttreibers auf, um nichtdevicespezifische Zuordnungen zu binden, die vom DxgkDdiCreateAllocation-Funktion erstellt wurden, um Zuordnungen zuzuordnen, die spezifisch für das Grafikkontextgerät sind, das vom hDevice Parameter angegeben wird. Der Miniporttreiber bindet Zuordnungen an ein Gerät, sodass der Treiber Die Zuordnungsdaten, die für ein Gerät spezifisch sind, nachverfolgen kann.

Der Display-Miniporttreiber kann eine Zuordnung an jedes Gerät binden, das von jedem Prozess (auf demselben Grafikadapter) erstellt wurde und nicht nur an ein Gerät im Erstellungsprozess.

Wenn DxgkDdiOpenAllocation STATUS_SUCCESS zurückgibt, legt der Treiber den hDeviceSpecificAllocation Member der DXGK_OPENALLOCATIONINFO Struktur für jede Zuordnung auf einen Wert ungleich NULL fest. Die DXGK_OPENALLOCATIONINFO Struktur für jede Zuordnung ist ein Element des Arrays, das vom pOpenAllocation Element der DXGKARG_OPENALLOCATION-Struktur angegeben wird.

Der Treiber kann die Zuordnungsdaten des privaten Treibers ändern, die im pPrivateDriverData- Mitglied der DXGK_OPENALLOCATIONINFO-Struktur übergeben werden, nur wenn die Zuordnung erstellt wird (die angegeben wird, wenn das Erstellen Bitfeldkennzeichnung im Flags Mitglied der DXGKARG_OPENALLOCATION Struktur festgelegt ist). Der Treiber sollte bestimmen, dass er die Zuordnungsdaten des privaten Treibers nur lesen kann, wenn die Zuordnung geöffnet wird (d. a. wenn die " Bitfeld-Flag erstellen" nicht festgelegt ist).

DxgkDdiOpenAllocation sollte seitenfähig gemacht werden.