Método IMDSPDevice3::D eviceIoControl (mswmdm.h)

Artículo
02/29/2024

El método DeviceIoControl llama al control de E/S del dispositivo.

Sintaxis

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

Parámetros

[in] dwIoControlCode

Código de control de E/S que se envía al dispositivo.

[in] lpInBuffer

Búfer de entrada proporcionado por la aplicación que realiza la llamada. Puede ser NULL si nInBufferSize es cero.

[in] nInBufferSize

Tamaño de lpInBuffer, en bytes.

[out] lpOutBuffer

Búfer de salida, proporcionado por la aplicación que realiza la llamada.

[in] pnOutBufferSize

Tamaño de lpOutBuffer, en bytes.

Valor devuelto

El método devuelve un valor HRESULT. Todos los métodos de interfaz de Windows Media Administrador de dispositivos pueden devolver cualquiera de las siguientes clases de códigos de error:

Códigos de error COM estándar
Códigos de error de Windows convertidos en valores HRESULT
Códigos de error de windows Media Administrador de dispositivos

Para obtener una lista extensa de posibles códigos de error, consulte Códigos de error.

Comentarios

Este método proporciona un modo privado de comunicación entre la aplicación y el proveedor de servicios. Después, el proveedor de servicios puede procesar este IOCTL, modificarlo opcionalmente y pasarlo al controlador en modo kernel.

En comparación con IMDSPDevice::SendOpaqueCommand, este método se alinea mejor con la API de Windows DeviceIoControl porque el autor de la llamada proporciona el búfer de salida. Además, a diferencia de IMDSPDevice::SendOpaqueCommand, este método no implica ninguna comprobación mac y es más eficaz.