다음을 통해 공유

PGET_DEVICE_INFORMATION 콜백 함수(hdaudio.h)

  • 아티클

GetDeviceInformation 루틴은 HD 오디오 컨트롤러 디바이스에 대한 정보를 검색합니다.

GetDeviceInformation 루틴에 대한 함수 포인터 형식은 다음과 같이 정의됩니다.

통사론

PGET_DEVICE_INFORMATION PgetDeviceInformation;

NTSTATUS PgetDeviceInformation(
  [in]      PVOID _context,
  [in, out] PHDAUDIO_DEVICE_INFORMATION DeviceInformation
)
{...}

매개 변수

[in] _context

HDAUDIO_BUS_INTERFACEContext 멤버 또는 HDAUDIO_BUS_INTERFACE_V2 구조체의 컨텍스트 값을 지정합니다.

[in, out] DeviceInformation

HD 오디오 컨트롤러 디바이스에 대한 정보를 검색합니다. 이 매개 변수는 루틴이 디바이스 정보를 쓰는 호출자가 할당한 HDAUDIO_DEVICE_INFORMATION 구조를 가리킵니다.

반환 값

GetDeviceInformation 호출이 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 루틴이 적절한 오류 코드를 반환합니다. 다음 표에서는 가능한 반환 상태 코드를 보여 줍니다.

반환 코드 묘사
STATUS_BUFFER_TOO_SMALL
 deviceInformation 버퍼의 시작 부분에 지정된 크기가 너무 작다는 것을 나타냅니다.

발언

이 루틴은 정적 디바이스 종속 정보를 검색합니다. 즉, 시간이 지남에 따라 정보가 동적으로 변경되지 않습니다.

deviceInformation 매개 변수는 루틴이 HD 오디오 컨트롤러에 대한 정보를 쓰는 HDAUDIO_DEVICE_INFORMATION 구조를 포함하는 버퍼에 대한 포인터입니다. GetDeviceInformation호출하기 전에 호출자는 버퍼를 할당하고 버퍼의 크기를 바이트 단위로 버퍼의 시작 부분에 있는 Size 멤버에 씁니다.

요구 사항

요구 값
대상 플랫폼 바탕 화면
헤더 hdaudio.h(Hdaudio.h 포함)
IRQL PASSIVE_LEVEL

참고 항목

HDAUDIO_BUS_INTERFACE

HDAUDIO_BUS_INTERFACE_V2

HDAUDIO_DEVICE_INFORMATION