PFND3DDDI_CONFIGUREAUTHENICATEDCHANNEL Rückruffunktion (d3dumddi.h)
Der ConfigureAuthenticatedChannel Funktionsstatus innerhalb eines authentifizierten Kanals festlegt.
Syntax
PFND3DDDI_CONFIGUREAUTHENICATEDCHANNEL Pfnd3dddiConfigureauthenicatedchannel;
HRESULT Pfnd3dddiConfigureauthenicatedchannel(
HANDLE hDevice,
const D3DDDIARG_CONFIGUREAUTHENTICATEDCHANNEL *unnamedParam2
)
{...}
Parameter
hDevice
Ein Handle für das Anzeigegerät (Grafikkontext).
unnamedParam2
pData- [in, out]
Ein Zeiger auf eine D3DDDIARG_CONFIGUREAUTHENTICATEDCHANNEL-Struktur, die beschreibt, wie ein authentifizierter Kanal konfiguriert wird. Diese Struktur enthält einen Eingabepuffer, der beschreibt, wie der authentifizierte Kanal und ein Ausgabepuffer mit Konfigurationsinformationen konfiguriert werden.
Rückgabewert
ConfigureAuthenticatedChannel gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
| S_OK | Der authentifizierte Kanal wurde erfolgreich konfiguriert. |
| E_OUTOFMEMORY | ConfigureAuthenticatedChannel konnte den erforderlichen Speicher nicht zuordnen, damit er abgeschlossen werden kann. |
Bemerkungen
Der Eingabepuffer enthält einen CBC-Modus (CBC)-Modus -Nachrichtenauthentifizierungscode (One-Key Cipher Block Chaining, OMAC), den der Treiber authentifizieren muss. Der Eingabepuffer enthält auch das Handle des Treibers für den authentifizierten Kanal, eine Sequenznummer und eine GUID, die den Konfigurationstyp angibt.
Der Treiber sollte ConfigureAuthenticatedChannel fehlschlagen, wenn der Eingabe-OMAC nicht übereinstimmt, wenn die Sequenznummer nicht größer als eine Sequenznummer ist, die in einem vorherigen Aufruf angegeben wurde, oder wenn die Sequenznummer noch nicht initialisiert wurde (die Ausnahme zu dieser letzten Regel ist für den Initialisierungsaufruf selbst).
Der Treiber sollte die Eingabedaten in der Struktur des Ausgabepuffers duplizieren und die Ausgabestruktur identisch mit der Verarbeitung Output Protection Manager (OPM)-Abfragen signieren.
Mit Ausnahme dieser Situationen, in denen die Anwendung einen zu kleinen Ausgabepuffer falsch angibt, sollte der Treiber immer den Rückgabecode in der Ausgabestruktur platzieren. Daher verfügt die Anwendung über einen sicheren Mechanismus, um den Rückgabecode zu ermitteln.
ConfigureAuthenticatedChannel verschiedene Vorgänge ausführen, je nach den folgenden GUIDs, die in der Eingabestruktur angegeben sind. Der Treiber sollte fehlschlagen, wenn die Eingabepuffergröße nicht mit der Größe übereinstimmt, die für die angegebene GUID definiert ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | ConfigureAuthenticatedChannel wird beginnend mit dem Windows 7-Betriebssystem unterstützt. |
| Zielplattform- | Desktop |
| Header- | d3dumddi.h (include D3dumddi.h) |