DrvGetModes-Funktion (winddi.h)

Artikel
08/27/2023

Die DrvGetModes-Funktion listet die Modi auf, die von einem bestimmten Gerät unterstützt werden.

Syntax

ULONG DrvGetModes(
  [in]            HANDLE   hDriver,
                  ULONG    cjSize,
  [out, optional] DEVMODEW *pdm
);

Parameter

[in] hDriver

Handle an den Treiber, für den die Modi aufgelistet werden müssen. Dies ist das Handle, das im hDriver-Parameter der DrvEnablePDEV-Funktion übergeben wird.

cjSize

Gibt die Größe des Puffers in Byte an, auf den pdm verweist.

[out, optional] pdm

Zeiger auf den Puffer, der DEVMODEW-Struktur (en) für den treiber zum Ausfüllen enthält, oder NULL.

Rückgabewert

Der Treiber sollte die Anzahl der in den Puffer geschriebenen Bytes zurückgeben, wenn pdm nicht NULL ist. Wenn pdmNULL ist, sollte der Treiber die Anzahl der Bytes zurückgeben, die erforderlich sind, um alle Modusdaten zu enthalten. Der Treiber sollte null zurückgeben, wenn ein Fehler auftritt.

Hinweise

Diese Funktion muss in allen Anzeigetreibern implementiert werden.

Der Fenster-Manager lädt dynamisch alle Anzeigetreiber, die einem Miniporttreiber zugeordnet sind (basierend auf dem Schlüssel InstalledDisplayDrivers in der Registrierung). Jeder Anzeigetreiber wird aufgerufen, um die Liste der Modi abzurufen, die von dieser Kombination geladener Treiber unterstützt werden. Beispielsweise gibt der VGA64K-Anzeigetreiber nur die 64K-Farbmodi zurück, die in der Liste der Vom Miniporttreiber abgerufenen Modi zurückgegeben wurden.

DrvGetModes kann aufgerufen werden, bevor ein aktiver PDEV vorhanden ist.

Eine funktionierende Implementierung von DrvGetModes finden Sie in den Permedia-Beispielen.

Hinweis Das Microsoft Windows Driver Kit (WDK) enthält nicht die Beispieltreiber 3Dlabs Permedia2 (3dlabs.htm ) und 3Dlabs Permedia3 (Perm3.htm). Sie können diese Beispieltreiber aus dem Windows Server 2003 SP1 Driver Development Kit (DDK) abrufen, das Sie auf der Seite DDK – Windows Driver Development Kit der WDHC-Website herunterladen können.