PFND3DDDI_GETPITCH Rückruffunktion (d3dumddi.h)
Die GetPitch-Funktion ruft die Tonhöhe einer geschützten oder nicht sperrbaren Oberfläche ab.
Syntax
PFND3DDDI_GETPITCH Pfnd3dddiGetpitch;
HRESULT Pfnd3dddiGetpitch(
HANDLE hDevice,
D3DDDIARG_GETPITCH *unnamedParam2
)
{...}
Parameter
hDevice
Ein Handle für das Anzeigegerät (Grafikkontext).
unnamedParam2
pData [in, out]
Ein Zeiger auf eine D3DDDIARG_GETPITCH Struktur, die die geschützte Oberfläche beschreibt.
Rückgabewert
Die GetPitch-Funktion gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
| S_OK | Die Tonhöhe der geschützten Oberfläche wurde erfolgreich abgerufen. |
| D3DDDIERR_NOTAVAILABLE | Der Treiber unterstützt die GetPitch-Funktion nicht. |
Hinweise
Hardware und Treiber können optional die GetPitch-Funktion unterstützen.
Die Oberfläche, für die die GetPitch-Funktion den Pitch zurückgibt, kann nicht gesperrt oder geschützt sein. Daher kann die Anwendung den Pitch der Oberfläche nicht über einen Aufruf der Lock-Funktion des Treibers abrufen. Die Anwendung muss den Pitch der Oberfläche abrufen, um den Systemspeicherpuffer ordnungsgemäß zuzuordnen, den die Anwendung anschließend in Aufrufen der Funktionen EncryptionBlt und DecryptionBlt des Treibers verwendet.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | GetPitch wird ab dem Windows 7-Betriebssystem unterstützt. |
| Zielplattform | Desktop |
| Kopfzeile | d3dumddi.h (include D3dumddi.h) |