PFND3DDDI_CREATEAUTHENTICATEDCHANNEL Rückruffunktion (d3dumddi.h)
Die CreateAuthenticatedChannel-Funktion erstellt einen Kanal, den die Microsoft Direct3D-Runtime und der Treiber zum Festlegen und Abfragen von Schutzmaßnahmen verwenden können.
Syntax
PFND3DDDI_CREATEAUTHENTICATEDCHANNEL Pfnd3dddiCreateauthenticatedchannel;
HRESULT Pfnd3dddiCreateauthenticatedchannel(
HANDLE hDevice,
D3DDDIARG_CREATEAUTHENTICATEDCHANNEL *unnamedParam2
)
{...}
Parameter
hDevice
Ein Handle für das Anzeigegerät (Grafikkontext).
unnamedParam2
pData [in, out]
Ein Zeiger auf eine D3DDDIARG_CREATEAUTHENTICATEDCHANNEL-Struktur . Bei der Eingabe enthält diese Struktur Informationen, die der Treiber verwenden kann. Bei der Ausgabe gibt der Treiber Informationen in der Struktur an, die die Direct3D-Runtime verwenden kann.
Rückgabewert
CreateAuthenticatedChannel gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
| S_OK | Der Kanal wurde erfolgreich erstellt. |
| E_OUTOFMEMORY | CreateAuthenticatedChannel konnte nicht den erforderlichen Arbeitsspeicher zuordnen, um ihn abzuschließen. |
| D3DDDIERR_NOTAVAILABLE | Der Treiber unterstützt nicht den Kanaltyp, der im ChannelType-Member der D3DDDIARG_CREATEAUTHENTICATEDCHANNEL-Struktur angegeben ist, auf die der pData-Parameter verweist. |
Hinweise
Die Runtime übergibt das Handle an den authentifizierten Kanal, den der Treiber im ChannelType-Member der D3DDDIARG_CREATEAUTHENTICATEDCHANNEL-Struktur bei allen nachfolgenden Aufrufen zurückgibt, die das Handle erfordern.
Der Treiber muss das Anzeigegerät (hDevice) nachverfolgen, das zum Erstellen des authentifizierten Kanals verwendet wurde. Der Treiber sollte bei allen nachfolgenden Aufrufen, die diesen erstellten authentifizierten Kanal verwenden (z. B. die AuthenticatedChannelKeyExchange-Funktion ), fehlschlagen, wenn sich das anzeigegerät, das in diesen Aufrufen angegeben wird, von dem Anzeigegerät unterscheidet, das zum Erstellen des authentifizierten Kanals verwendet wurde.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | CreateAuthenticatedChannel wird ab dem Windows 7-Betriebssystem unterstützt. |
| Zielplattform | Desktop |
| Kopfzeile | d3dumddi.h (include D3dumddi.h) |