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_OK zurück. Wenn die Methode fehlschlägt, weil der Parameter ppSpecContext einen ungültigen Zeiger angibt, gibt die Methode E_INVALIDARG zurück. Wenn die Methode aus einem anderen Grund fehlschlägt, wird ein COM-Standardfehlercode zurückgegeben.
Hinweise
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 Treiberdienstbibliotheksfunktion wiasCreateDrvItem erstellt wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | wiamindr_lh.h (einschließlich Wiamindr.h) |