IMDSPDevice3::D eviceIoControl-Methode (mswmdm.h)

Artikel
02/29/2024

Die DeviceIoControl-Methode ruft das E/A-Steuerelement des Geräts auf.

Syntax

HRESULT DeviceIoControl(
  [in]  DWORD   dwIoControlCode,
  [in]  BYTE    *lpInBuffer,
  [in]  DWORD   nInBufferSize,
  [out] BYTE    *lpOutBuffer,
  [in]  LPDWORD pnOutBufferSize
);

Parameter

[in] dwIoControlCode

E/A-Steuerungscode, der an das Gerät gesendet wird.

[in] lpInBuffer

Eingabepuffer, der von der aufrufenden Anwendung bereitgestellt wird. Dies kann NULL sein, wenn nInBufferSize null ist.

[in] nInBufferSize

Größe von lpInBuffer in Bytes.

[out] lpOutBuffer

Ausgabepuffer, der von der aufrufenden Anwendung bereitgestellt wird.

[in] pnOutBufferSize

Größe von lpOutBuffer in Bytes.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Alle Schnittstellenmethoden in Windows Media Geräte-Manager können eine der folgenden Klassen von Fehlercodes zurückgeben:

Com-Standardfehlercodes
In HRESULT-Werte konvertierte Windows-Fehlercodes
Windows Media Geräte-Manager Fehlercodes

Eine ausführliche Liste möglicher Fehlercodes finden Sie unter Fehlercodes.

Hinweise

Diese Methode stellt einen privaten Kommunikationsmodus zwischen der Anwendung und dem Dienstanbieter bereit. Der Dienstanbieter kann diese IOCTL dann verarbeiten, optional ändern und an den Kernelmodustreiber übergeben.

Im Vergleich zu IMDSPDevice::SendOpaqueCommand ist diese Methode besser an der DeviceIoControl-Windows-API ausgerichtet, da der Ausgabepuffer vom Aufrufer bereitgestellt wird. Im Gegensatz zu IMDSPDevice::SendOpaqueCommand beinhaltet diese Methode keine MAC-Überprüfung und ist effizienter.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	mswmdm.h
Bibliothek	Mssachlp.lib

Weitere Informationen

IMDSPDevice3-Schnittstelle

IMDSPDevice::SendOpaqueCommand

IWMDMDevice3::D eviceIoControl

Freigeben über