Partilhar via


Método IStiUSD::GetStatus (stiusd.h)

O método IStiUSD::GetStatus de um minidriver de imagem ainda retorna o status de um dispositivo de imagem morta.

Sintaxe

HRESULT GetStatus(
  PSTI_DEVICE_STATUS pDevStatus
);

Parâmetros

pDevStatus

Ponteiro fornecido pelo chamador para uma estrutura STI_DEVICE_STATUS.

Valor de retorno

Se a operação for bem-sucedida, o método deverá retornar S_OK. Caso contrário, ele deverá retornar um dos códigos de erro prefixados por STIERR definidos em stierr.h.

Observações

O chamador fornece valores para os dwSize e StatusMask membros da estrutura STI_DEVICE_STATUS e o minidriver deve fornecer valores para o restante dos membros da estrutura.

Se o driver tiver definido anteriormente o sinalizador STI_GENCAP_POLLING_NEEDED na estrutura de STI_DEV_CAPS do dispositivo, o método IStiUSD::GetStatus do minidriver é o meio pelo qual o monitor de eventos determina se ocorreu um de Eventos de Dispositivo de Imagem Ainda. O monitor de eventos chamará o método, especificando STI_DEVSTATUS_EVENT_STATE na estrutura de STI_DEVICE_STATUS fornecida. O driver deve sondar o dispositivo e definir STI_EVENTHANDLING_PENDING se um evento tiver ocorrido.

Se o chamador especificar STI_DEVSTATUS_ONLINE_STATE na estrutura de STI_DEVICE_STATUS fornecida, o minidriver deverá definir o sinalizador apropriado no membro dwOnlineState da estrutura.

Requisitos

Requisito Valor
da Plataforma de Destino Área de trabalho
cabeçalho stiusd.h (inclua Stiusd.h)

Consulte também

IStiDevice::GetStatus

IStiUSD