DXGKDDI_VIDPN_CREATENEWSOURCEMODESET Rückruffunktion (d3dkmddi.h)
Die pfnCreateNewSourceModeSet-Funktion erstellt ein neues Quellmodussatzobjekt in einem angegebenen VidPN-Objekt.
Syntax
DXGKDDI_VIDPN_CREATENEWSOURCEMODESET DxgkddiVidpnCreatenewsourcemodeset;
NTSTATUS DxgkddiVidpnCreatenewsourcemodeset(
[in] IN_CONST_D3DKMDT_HVIDPN hVidPn,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId,
[out] OUT_PD3DKMDT_HVIDPNSOURCEMODESET phNewVidPnSourceModeSet,
[out] DEREF_OUT_CONST_PPDXGK_VIDPNSOURCEMODESET_INTERFACE ppVidPnSourceModeSetInterface
)
{...}
Parameter
[in] hVidPn
Ein Handle für ein VidPN-Objekt. Der VidPN-Manager hat dieses Handle zuvor für den Anzeigeminiporttreiber bereitgestellt, indem er DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn oder DxgkDdiRecommendFunctionalVidPn aufgerufen hat.
[in] VidPnSourceId
Eine ganze Zahl, die eine der vorhandenen Videoquellen identifiziert, die dem VidPN-Objekt zugeordnet sind.
[out] phNewVidPnSourceModeSet
Ein Zeiger auf eine Variable, die ein Handle auf das neu erstellte Quellmodussatzobjekt empfängt.
[out] ppVidPnSourceModeSetInterface
Ein Zeiger auf eine Variable, die einen Zeiger auf eine DXGK_VIDPNSOURCEMODESET_INTERFACE-Struktur empfängt. Die Struktur enthält Zeiger auf Funktionen, die der Anzeigeminiporttreiber aufrufen kann, um das Quellmodussatzobjekt zu überprüfen und zu ändern.
Rückgabewert
Die PfnCreateNewSourceModeSet-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 arbeitsspeicher nicht zuordnen, der zum Erstellen des neuen Quellmodussatzobjekts erforderlich ist. |
Hinweise
Führen Sie die folgenden Schritte aus, um einer bestimmten Quelle in einem VidPN einen neuen Quellmodus zuzuweisen:
- Rufen Sie pfnCreateNewSourceModeSet auf, um ein Handle für ein neues Quellmodus-Setobjekt abzurufen. Dieses Quellmodussatzobjekt gehört zu einem bestimmten VidPN-Objekt, das Sie angeben.
- Verwenden Sie die Funktionen der DXGK_VIDPNSOURCEMODESET_INTERFACE-Schnittstelle , um dem Quellmodussatzobjekt Modi hinzuzufügen.
- Rufen Sie pfnAssignSourceModeSet auf, um den neuen Quellmodus einer bestimmten Quelle zuzuweisen.
Wenn Sie ein Handle erhalten, indem Sie pfnCreateNewSourceModeSet aufrufen und dann entscheiden, den neuen Quellmodus nicht einer Quelle zuzuweisen, müssen Sie das neu abgerufene Handle freigeben, indem Sie pfnReleaseSourceModeSet aufrufen.
Die Lebensdauer der in ppVidPnSourceModeSetInterface zurückgegebenen DXGK_VIDPNSOURCEMODESET_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_HVIDPNSOURCEMODESET werden 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 |