DXGKDDI_OPENALLOCATIONINFO Rückruffunktion (d3dkmddi.h)

Artikel
05/26/2023

Die DxgkDdiOpenAllocation-Funktion bindet nicht gerätespezifische Zuordnungen, die von der DxgkDdiCreateAllocation-Funktion erstellt wurden, an Zuordnungen, 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 Display-Miniporttreibers hat dieses Handle zuvor für das Microsoft DirectX-Grafikkernsystem im hDevice-Member der DXGKARG_CREATEDEVICE-Struktur bereitgestellt.

[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 hat Zuordnungen erfolgreich an das Grafikkontextgerät gebunden, das vom hDevice-Parameter angegeben wurde.
STATUS_INVALID_PARAMETER	Parameter, die an DxgkDdiOpenAllocation übergeben wurden, enthielten Fehler, die den Abschluss verhinderten.
STATUS_NO_MEMORY	DxgkDdiOpenAllocation konnte keinen Speicher zuordnen, der für den Abschluss erforderlich war.
STATUS_GRAPHICS_DRIVER_MISMATCH	Der Anzeige-Miniporttreiber ist nicht kompatibel mit dem Anzeigetreiber im Benutzermodus, der den Aufruf von DxgkDdiOpenAllocation initiiert hat (d. h. private Daten für den Display-Miniporttreiber bereitgestellt).

Hinweise

Das DirectX-Grafikkernsubsystem ruft die DxgkDdiOpenAllocation-Funktion des Anzeigeminiporttreibers auf, um nichtvice-spezifische Zuordnungen, die die DxgkDdiCreateAllocation-Funktion erstellt hat, an Zuordnungen zu binden, die spezifisch für das Grafikkontextgerät sind, das vom Parameter hDevice angegeben wird. Der Anzeige-Miniporttreiber bindet Zuordnungen an ein Gerät, damit der Treiber die für ein Gerät spezifischen Zuordnungsdaten nachverfolgen kann.

Der Display-Miniporttreiber kann eine Zuordnung an jedes Gerät binden, das von jedem Prozess (auf demselben Grafikkarte) erstellt wurde, und nicht nur an ein Gerät, das sich beim Erstellen befindet.

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 der pOpenAllocation-Member der DXGKARG_OPENALLOCATION-Struktur angibt.

Der Treiber kann die Daten des privaten Zuordnungstreibers ändern, die im pPrivateDriverData-Member der DXGK_OPENALLOCATIONINFO-Struktur übergeben werden, wenn die Zuordnung erstellt wird (dies wird angegeben, wenn das Flag " Bitfeld erstellen" im Flags-Element der DXGKARG_OPENALLOCATION-Struktur festgelegt ist). Der Treiber sollte feststellen, dass er die Daten des privaten Zuteilungstreibers nur lesen kann, wenn die Zuordnung geöffnet wird (d. a. wenn das Flag Bitfeld erstellen nicht festgelegt ist).

DxgkDdiOpenAllocation sollte als ausgelagert werden.