DXGKDDI_VIDPN_CREATENEWTARGETMODESET Rückruffunktion (d3dkmddi.h)
Die pfnCreateNewTargetModeSet-Funktion erstellt ein neues Zielmodus-Set-Objekt in einem angegebenen VidPN-Objekt.
Syntax
DXGKDDI_VIDPN_CREATENEWTARGETMODESET DxgkddiVidpnCreatenewtargetmodeset;
NTSTATUS DxgkddiVidpnCreatenewtargetmodeset(
[in] IN_CONST_D3DKMDT_HVIDPN hVidPn,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
[out] OUT_PD3DKMDT_HVIDPNTARGETMODESET phNewVidPnTargetModeSet,
[out] DEREF_OUT_CONST_PPDXGK_VIDPNTARGETMODESET_INTERFACE ppVidPnTargetModeSetInterace
)
{...}
Parameter
[in] hVidPn
Ein Handle für ein VidPN-Objekt. Der VidPN-Manager hat dieses Handle zuvor für den Anzeige-Miniporttreiber bereitgestellt, indem er DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn oder DxgkDdiRecommendFunctionalVidPn aufgerufen hat.
[in] VidPnTargetId
Eine ganze Zahl, die eines der dem VidPN-Objekt zugeordneten Videoziele identifiziert.
[out] phNewVidPnTargetModeSet
Ein Zeiger auf eine Variable, die ein Handle für das neu erstellte Zielmodus-Setobjekt empfängt.
[out] ppVidPnTargetModeSetInterace
Ein Zeiger auf eine Variable, die einen Zeiger auf eine DXGK_VIDPNTARGETMODESET_INTERFACE-Struktur empfängt. Die -Struktur enthält Zeiger auf Funktionen, die der Anzeige-Miniporttreiber aufrufen kann, um das Zielmodus-Setobjekt zu überprüfen und zu ändern.
Rückgabewert
Die PfnCreateNewTargetModeSet-Funktion gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_SUCCESS | Die Funktion wurde erfolgreich ausgeführt. |
| STATUS_GRAPHICS_INVALID_VIDPN | Das in hVidPn angegebene Handle war ungültig. |
| STATUS_NO_MEMORY | Der VidPN-Manager konnte den zum Erstellen des neuen Zielmodusobjekts erforderlichen Arbeitsspeicher nicht zuordnen. |
Hinweise
Führen Sie die folgenden Schritte aus, um einem bestimmten Ziel in einer VidPN-Implementierung einen neuen Zielmodus zuzuweisen:
- Rufen Sie pfnCreateNewTargetModeSet auf, um ein Handle für ein neues Zielmodus-Setobjekt abzurufen. Dieses Zielmodus-Set-Objekt gehört zu einem bestimmten VidPN-Objekt, das Sie angeben.
- Verwenden Sie die Funktionen der DXGK_VIDPNTARGETMODESET_INTERFACE-Struktur , um dem Zielmodus-Setobjekt Modi hinzuzufügen.
- Rufen Sie pfnAssignTargetModeSet auf, um den neuen Zielmodus zuzuweisen, der einem bestimmten Ziel festgelegt ist.
Wenn Sie ein Handle erhalten, indem Sie pfnCreateNewTargetModeSet aufrufen und dann entscheiden, den neuen Zielmodus nicht einem Ziel zuzuweisen, müssen Sie das neu abgerufene Handle freigeben, indem Sie pfnReleaseTargetModeSet aufrufen.
Die Lebensdauer der in ppVidPnTargetModeSetInterface zurückgegebenen DXGK_VIDPNTARGETEMODESET_INTERFACE-Struktur gehört dem Betriebssystem. Mit diesem Besitzschema kann das Betriebssystem zur Laufzeit zu neueren Implementierungen wechseln, ohne clients der Schnittstelle zu unterbrechen.
Die Datentypen D3DKMDT_HVIDPN und D3DKMDT_HVIDPNTARGETMODESET sind 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 |