PFND3DDDI_QUERYAUTHENTICATEDCHANNEL Rückruffunktion (d3dumddi.h)

  • Artikel

Die QueryAuthenticatedChannel-Funktion fragt einen authentifizierten Kanal nach Funktions- und Zustandsinformationen ab.

Syntax

PFND3DDDI_QUERYAUTHENTICATEDCHANNEL Pfnd3dddiQueryauthenticatedchannel;

HRESULT Pfnd3dddiQueryauthenticatedchannel(
  HANDLE hDevice,
  const D3DDDIARG_QUERYAUTHENTICATEDCHANNEL *unnamedParam2
)
{...}

Parameter

hDevice

Ein Handle für das Anzeigegerät (Grafikkontext).

unnamedParam2

pData [ein, aus]

Ein Zeiger auf eine D3DDDIARG_QUERYAUTHENTICATEDCHANNEL Struktur, die authentifizierte Kanalinformationen beschreibt, die abgefragt werden sollen. Diese Struktur enthält einen Eingabepuffer, der die Abfrage beschreibt, und einen Ausgabepuffer, um die abgefragten Informationen zurückzugeben.

Rückgabewert

QueryAuthenticatedChannel gibt einen der folgenden Werte zurück:

Rückgabecode Beschreibung
S_OK Der authentifizierte Kanal wurde erfolgreich abgefragt.
E_OUTOFMEMORY QueryAuthenticatedChannel konnte den erforderlichen Arbeitsspeicher nicht zuordnen, damit er abgeschlossen werden konnte.

Hinweise

Der Eingabepuffer enthält das Handle des Treibers für den authentifizierten Kanal, eine Sequenznummer und eine GUID, die den Abfragetyp angibt. Der Treiber sollte alle Abfragen fehlschlagen, wenn der Treiber die Sequenznummer zuvor nicht über einen Aufruf seiner ConfigureAuthenticatedChannel-Funktion initialisiert hat. Der Treiber sollte auch bei der Abfrage fehlschlagen, wenn die Sequenznummer nicht größer als die Sequenznummer des vorherigen Abfrageaufrufs ist.

Der Treiber sollte die Eingabedaten in der Struktur des Ausgabepuffers duplizieren und die Ausgabestruktur identisch mit der aktuellen Verarbeitung von OPM-Abfragen ( Output Protection Manager ) signieren.

Mit Ausnahme der Situationen, in denen die Anwendung fälschlicherweise einen zu kleinen Ausgabepuffer angibt, sollte der Treiber den Rückgabecode immer in der Ausgabestruktur platzieren. Daher verfügt die Anwendung über einen sicheren Mechanismus, um den Rückgabecode zu bestimmen.

QueryAuthenticatedChannel führt unterschiedliche Vorgänge aus, abhängig von den folgenden GUIDs, die in der Eingabestruktur angegeben sind. Der Treiber sollte fehlschlagen, wenn die Größe des Eingabe- und Ausgabepuffers nicht den Größen entsprechen, die für die angegebene GUID definiert sind.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) QueryAuthenticatedChannel wird ab dem Windows 7-Betriebssystem unterstützt.
Zielplattform Desktop
Kopfzeile d3dumddi.h (include D3dumddi.h)

Weitere Informationen

ConfigureAuthenticatedChannel

D3DDDIARG_QUERYAUTHENTICATEDCHANNEL