DXGKDDI_VIDPNSOURCEMODESET_ADDMODE Rückruffunktion (d3dkmddi.h)
Die pfnAddMode-Funktion fügt einem angegebenen VidPN-Quellmodussatzobjekt einen VidPN-Quellmodus hinzu.
Syntax
DXGKDDI_VIDPNSOURCEMODESET_ADDMODE DxgkddiVidpnsourcemodesetAddmode;
NTSTATUS DxgkddiVidpnsourcemodesetAddmode(
[in] IN_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
[in] IN_PD3DKMDT_VIDPN_SOURCE_MODE_CONST pVidPnSourceModeInfo
)
{...}
Parameter
[in] hVidPnSourceModeSet
Ein Handle für ein VidPN-Quellmodus-Setobjekt. Der Anzeigeminiporttreiber hat dieses Handle zuvor durch Aufrufen der PfnAcquireSourceModeSet-Funktion der DXGK_VIDPN_INTERFACE-Schnittstelle abgerufen.
[in] pVidPnSourceModeInfo
Ein Zeiger auf eine D3DKMDT_VIDPN_SOURCE_MODE Struktur, die den Quellmodus beschreibt. Der Anzeigeminiporttreiber hat diese Struktur zuvor durch Aufrufen von pfnCreateNewModeInfo abgerufen.
Rückgabewert
Die pfnAddMode-Funktion gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_SUCCESS | Die Funktion wurde erfolgreich ausgeführt. |
| STATUS_GRAPHICS_INVALID_VIDPN_SOURCEMODESET | Das in hVidPnSourceModeSet angegebene Handle war ungültig. |
Hinweise
Um einem Quellmodussatz einen Modus hinzuzufügen, führt der Anzeigeminiporttreiber die folgenden Schritte aus.
Rufen Sie pfnCreateNewModeInfo auf, um einen Zeiger auf eine D3DKMDT_VIDPN_SOURCE_MODE-Struktur abzurufen. Die pnfCreateNewModeInfo-Funktion weist die Struktur zu, füllt das Id-Member mit einem neu generierten Quellmodusbezeichner aus und legt das Type-Element auf D3DKMDT_RMT_UNINITIALIZED fest.
Füllen Sie die D3DKMDT_VIDPN_SOURCE_MODE-Struktur (mit Ausnahme des Id-Members ) mit Informationen zum Modus, einschließlich des Typs und Des Formats des Modus.
Rufen Sie pfnAddMode auf, um den Modus einem Quellmodussatz hinzuzufügen.
Der VidPN-Manager weist eine D3DKMDT_VIDPN_SOURCE_MODE-Struktur zu, wenn Sie pfnCreateNewModeInfo aufrufen. Wenn Sie den von dieser Struktur beschriebenen Modus einem Quellmodussatz hinzufügen, müssen Sie die Struktur nicht explizit freigeben. pfnAddMode gibt es frei.
Wenn Sie eine D3DKMDT_VIDPN_SOURCE_MODE-Struktur erhalten, indem Sie pfnCreateNewModeInfo aufrufen und dann entscheiden, diesen Modus nicht einem Quellmodussatz hinzuzufügen, müssen Sie die Struktur explizit freigeben, indem Sie pfnReleaseModeInfo aufrufen.
Der D3DKMDT_HVIDPNSOURCEMODESET Datentyp ist in D3dkmdt.h definiert.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Zielplattform | Desktop |
| Kopfzeile | d3dkmddi.h (einschließlich D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |