IWiaDrvItem::GetDeviceSpecContext-Methode (wiamindr_lh.h)

Die IWiaDrvItem::GetDeviceSpecContext Methode ruft einen gerätespezifischen Kontext ab.

Syntax

HRESULT GetDeviceSpecContext(
  BYTE **__MIDL__IWiaDrvItem0001
);

Parameter

__MIDL__IWiaDrvItem0001

ppSpecContext- [out, optional]

Verweist auf einen Speicherspeicherort, der die Adresse eines gerätespezifischen Kontexts empfängt.

Rückgabewert

Wenn die Methode erfolgreich ist, speichert sie einen Zeiger auf den gerätespezifischen Kontext in ppSpecContext- und gibt S_OKzurück. Wenn die Methode fehlschlägt, da der Parameter ppSpecContext einen ungültigen Zeiger angibt, gibt die Methode E_INVALIDARGzurück. Wenn die Methode aus einem anderen Grund fehlschlägt, wird ein standardmäßiger COM-Fehlercode zurückgegeben.

Bemerkungen

Minidriver verwenden diese Methode in der Regel, um einen Zeiger auf einen gerätespezifischen Kontext abzurufen, der einem IWiaDrvItem Element zugeordnet ist. Der gerätespezifische Kontext wird dem Element zugeordnet, wenn das Element mithilfe der Treiberdienste-Bibliotheksfunktion wiasCreateDrvItemerstellt wird.

Anforderungen

Siehe auch

IWiaDrvItem

wiasCreateDrvItem