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

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

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

Weitere Informationen

IMDSPDevice3-Schnittstelle

IMDSPDevice::SendOpaqueCommand

IWMDMDevice3::D eviceIoControl