Freigeben über


PFND3DDDI_QUERYAUTHENTICATEDCHANNEL Rückruffunktion (d3dumddi.h)

Die QueryAuthenticatedChannel-Funktion fragt einen authentifizierten Kanal nach Funktions- und Statusinformationen 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- [in, out]

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

Rückgabewert

QueryAuthenticatedChannel gibt einen der folgenden Werte zurück:

Rückgabecode Beschreibung
S_OK Der authentifizierte Kanal wird erfolgreich abgefragt.
E_OUTOFMEMORY QueryAuthenticatedChannel konnte den erforderlichen Speicher für den Abschluss nicht zuordnen.

Bemerkungen

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 nicht ausführen, wenn der Treiber die Sequenznummer zuvor nicht über einen Aufruf der ConfigureAuthenticatedChannel--Funktion initialisiert hat. Der Treiber sollte auch die 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 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.

QueryAuthenticatedChannel verschiedene Vorgänge ausführen, je nach den folgenden GUIDs, die in der Eingabestruktur angegeben sind. Der Treiber sollte fehlschlagen, wenn die Eingabe- und Ausgabepuffergrößen nicht mit den Größen übereinstimmen, die für die angegebene GUID definiert sind.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- QueryAuthenticatedChannel wird beginnend mit dem Windows 7-Betriebssystem unterstützt.
Zielplattform- Desktop
Header- d3dumddi.h (include D3dumddi.h)

Siehe auch

ConfigureAuthenticatedChannel-

D3DDDIARG_QUERYAUTHENTICATEDCHANNEL