PFND3D11_1DDI_CONFIGUREAUTHENTICATEDCHANNEL Rückruffunktion (d3d10umddi.h)
Verarbeitet eine Anforderung von einer Anwendung, um einen authentifizierten Kanal für den Inhaltsschutz zu konfigurieren. Wird von einem Windows Display Driver Model (WDDM) 1.2 oder höher für den Benutzermodus-Anzeigetreiber implementiert.
Syntax
PFND3D11_1DDI_CONFIGUREAUTHENTICATEDCHANNEL Pfnd3d111DdiConfigureauthenticatedchannel;
HRESULT Pfnd3d111DdiConfigureauthenticatedchannel(
D3D10DDI_HDEVICE hDevice,
D3D11_1DDI_HAUTHCHANNEL hCAuthChannel,
UINT InputDataSize,
const VOID *pInputData,
D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT *pOutputData
)
{...}
Parameter
hDevice
Ein Handle für das Anzeigegerät (Grafikkontext).
hCAuthChannel
Ein Handle für das authentifizierte Kanalobjekt, das durch einen Aufruf der CreateAuthenticatedChannel(D3D11_1)- Funktion erstellt wurde.
InputDataSize
Die Größe des Arrays in Bytes, das durch den pInputData-Parameter angegeben wird.
pInputData
Ein Zeiger auf ein Bytearray, das Eingabedaten für den Befehl enthält. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.
pOutputData
Ein Zeiger auf eine D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT-Struktur . Weitere Informationen finden Sie im Abschnitt mit Hinweisen.
Rückgabewert
Gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
| S_OK | Der authentifizierte Kanal wurde erfolgreich konfiguriert. |
| E_FAIL | Der Anzeige-Miniporttreiber unterstützt den angegebenen Befehl nicht. |
| E_INVALIDARG | Die Parameter wurden überprüft und als falsch ermittelt. |
| E_OUTOFMEMORY | Der Arbeitsspeicher war zum Abschließen des Vorgangs nicht verfügbar. |
Hinweise
Das Bytearray, auf das vom pInputData-Parameter verwiesen wird, wird wie folgt formatiert:
Dieses Array beginnt mit einer D3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT-Struktur .
Die Daten, die auf diese Struktur folgen, haben ein Format, das vom ConfigureType-Member der -Struktur angegeben wird.
In der folgenden Liste wird das Format dieser Daten basierend auf dem ConfigureType-Element beschrieben.
D3D11_1DDI_AUTHENTICATED_CONFIGURE_CRYPTO_SESSION_GUIDD3D11_1DDI_AUTHENTICATED_CONFIGURE_CRYPTO_SESSION
D3D11_1DDI_AUTHENTICATED_CONFIGURE_ENCRYPTION_WHEN_ACCESSIBLE_GUIDD3D11_1DDI_AUTHENTICATED_CONFIGURE_ACCESSIBLE_ENCRYPTION
D3D11_1DDI_AUTHENTICATED_CONFIGURE_INITIALIZE_GUIDD3D11_1DDI_AUTHENTICATED_CONFIGURE_INITIALIZE
D3D11_1DDI_AUTHENTICATED_CONFIGURE_PROTECTION_GUIDD3D11_1DDI_AUTHENTICATED_CONFIGURE_PROTECTION
D3D11_1DDI_AUTHENTICATED_CONFIGURE_SHARED_RESOURCE_GUIDD3D11_1DDI_AUTHENTICATED_CONFIGURE_SHARED_RESOURCE
Die D3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT-Struktur enthält einen AES-basierten CBC-Nachrichtenauthentifizierungscode (OMAC) mit einem Schlüssel für die Daten. Der Anzeige-Miniporttreiber muss seinen eigenen OMAC für die Daten berechnen, um die Daten zu authentifizieren. Diese Eingabestruktur enthält auch ein Treiberhandle für den authentifizierten Kanal, eine Sequenznummer und eine GUID, die den Konfigurationstyp angibt.
Der Anzeigeminiporttreiber führt die folgenden Schritte aus, wenn er die D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT-Struktur initialisiert:
Der Treiber muss die Eingabedaten in die D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT-Struktur kopieren.
Der Treiber muss den ReturnCode-Member auf denselben Rückgabecode festlegen, den er für den Aufruf ConfigureAuthenticatedChannel(D3D11_1) zurückgibt. Dies bietet der Anwendung einen sicheren Mechanismus für den Zugriff auf den Rückgabecode.
Der Treiber legt den omac-Member auf 0 (null) fest und berechnet dann einen OMAC für die Daten in der -Struktur. Der Treiber legt dann den omac-Member auf den OMAC fest, den er berechnet hat.
Der Display-Miniporttreiber muss unter den folgenden Bedingungen E_INVALIDARG für den ConfigureAuthenticatedChannel-Aufruf zurückgeben:
Der omac-Member derD3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT-Struktur stimmt nicht mit dem OMAC überein, den der Treiber berechnet hat.
Die Sequenznummer ist nicht größer als eine Sequenznummer, die in einem vorherigen Konfigurationsaufruf angegeben wurde.
Die Sequenznummer wurde noch nicht durch einen Aufruf der ConfigureAuthenticatedChannel(D3D11_1)-Funktion initialisiert.
Der InputDataSize-Parameter ist kleiner als die Größe der D3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT-Struktur plus die Größe der struktur, die vom D3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT angegeben wird. ConfigureTypemember.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 |
| Unterstützte Mindestversion (Server) | Windows Server 2012 |
| Zielplattform | Desktop |
| Kopfzeile | d3d10umddi.h (include D3d10umddi.h) |
Weitere Informationen
CreateAuthenticatedChannel(D3D11_1)