PFND3D11_1DDI_CONFIGUREAUTHENTICATEDCHANNEL Rückruffunktion (d3d10umddi.h)
Verarbeitet eine Anforderung einer Anwendung, um einen authentifizierten Kanal für den Inhaltsschutz zu konfigurieren. Implementiert durch einen Windows Display Driver Model (WDDM) 1.2 oder höher Benutzermodusanzeigetreiber.
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 über einen Aufruf der CreateAuthenticatedChannel(D3D11_1)-Funktion erstellt wurde.
InputDataSize
Die Größe des Arrays in Byte, das vom pInputData-Parameter angegeben wird.
pInputData
Ein Zeiger auf ein Bytearray, das Eingabedaten für den Befehl enthält. Weitere Informationen finden Sie im Abschnitt "Hinweise".
pOutputData
Ein Zeiger auf eine D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT Struktur. Weitere Informationen finden Sie im Abschnitt "Hinweise".
Rückgabewert
Gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
| S_OK | Der authentifizierte Kanal wurde erfolgreich konfiguriert. |
| E_FAIL | Der Anzeigeminiporttreiber unterstützt den angegebenen Befehl nicht. |
| E_INVALIDARG | Parameter wurden überprüft und ermittelt, dass sie falsch sind. |
| E_OUTOFMEMORY | Der Arbeitsspeicher war nicht verfügbar, um den Vorgang abzuschließen. |
Bemerkungen
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, befinden sich in einem Format, das vom ConfigureType Member der Struktur angegeben wird.
In der folgenden Liste wird das Format dieser Daten basierend auf dem ConfigureType Member 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) der Daten. Der Anzeige-Miniporttreiber muss einen eigenen OMAC über 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 Miniporttreiber für die Anzeige folgt den folgenden Schritten, 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 das ReturnCode-Element auf denselben Rückgabecode festlegen, den er für den ConfigureAuthenticatedChannel(D3D11_1)-Aufruf zurückgibt. Dadurch erhält die Anwendung einen sicheren Mechanismus für den Zugriff auf den Rückgabecode.
Der Treiber legt das omac-Element auf Null fest und berechnet dann einen OMAC für die Daten in der Struktur. Der Treiber legt dann das omac-Element auf den OMAC fest, den er berechnet hat.
Der Miniporttreiber der Anzeige muss E_INVALIDARG für den Aufruf ConfigureAuthenticatedChannel unter den folgenden Bedingungen zurückgeben:
Das omac-Element 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 sowie die Größe der durch die D3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT angegebenen Struktur. ConfigureTypemember.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 8 |
| mindestens unterstützte Server- | Windows Server 2012 |
| Zielplattform- | Desktop |
| Header- | d3d10umddi.h (include D3d10umddi.h) |
Siehe auch
CreateAuthenticatedChannel(D3D11_1)