DXGKDDI_VIDPNTARGETMODESET_PINMODE Rückruffunktion (d3dkmddi.h)

Die pfnPinMode-Funktion heftet einen angegebenen Modus in einem VidPN-Zielmodus an.

Syntax

DXGKDDI_VIDPNTARGETMODESET_PINMODE DxgkddiVidpntargetmodesetPinmode;

NTSTATUS DxgkddiVidpntargetmodesetPinmode(
  [in] IN_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
  [in] IN_CONST_D3DKMDT_VIDEO_PRESENT_TARGET_MODE_ID VidPnTargetModeId
)
{...}

Parameter

[in] hVidPnTargetModeSet

Ein Handle für ein VidPN-Zielmodus-Setobjekt. Der Anzeige-Miniporttreiber hat dieses Handle zuvor durch Aufrufen der pfnAcquireTargetModeSet-Funktion der DXGK_VIDPN_INTERFACE-Schnittstelle abgerufen.

[in] VidPnTargetModeId

Eine ganze Zahl, die den anheftenden Modus angibt.

Rückgabewert

Die pfnPinMode-Funktion gibt einen der folgenden Werte zurück:

Rückgabecode Beschreibung
STATUS_SUCCESS Die Funktion wurde erfolgreich ausgeführt.
STATUS_GRAPHICS_INVALID_VIDPN_TARGETMODESET Das in hVidPnTargetModeSet bereitgestellte Handle war ungültig.
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET_MODE Der durch VidPnTargetModeId identifizierte Modus gehört nicht zum Quellmodussatz, der durch hVidPnTargetModeSet dargestellt wird.

Hinweise

VidPN-Zielmodusbezeichner werden vom Betriebssystem zugewiesen. Die pfnCreateNewModeInfo-Funktion generiert einen Modusbezeichner, weist den Bezeichner dem Id-Member einer D3DKMDT_VIDPN_TARGET_MODE-Struktur zu und gibt die Struktur an den Anzeige-Miniporttreiber zurück.

Der datentyp D3DKMDT_HVIDPNTARGETMODESET wird 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